@signalwire/sdk 2.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/.github/workflows/publish.yml +27 -0
- package/.github/workflows/test.yml +17 -0
- package/CLAUDE.md +112 -0
- package/README.md +254 -0
- package/docs/MIGRATION-2.0.md +81 -0
- package/docs/agent-guide.md +869 -0
- package/docs/agent_guide.md +1026 -0
- package/docs/api-reference.md +2420 -0
- package/docs/api_reference.md +1301 -0
- package/docs/architecture.md +843 -0
- package/docs/cli-guide.md +579 -0
- package/docs/cli_guide.md +448 -0
- package/docs/cloud_functions_guide.md +474 -0
- package/docs/configuration.md +422 -0
- package/docs/contexts-guide.md +787 -0
- package/docs/contexts_guide.md +511 -0
- package/docs/datamap-guide.md +1141 -0
- package/docs/datamap_guide.md +595 -0
- package/docs/llm_parameters.md +239 -0
- package/docs/mcp_gateway_reference.md +648 -0
- package/docs/mcp_integration.md +108 -0
- package/docs/prefabs-guide.md +800 -0
- package/docs/sdk_features.md +477 -0
- package/docs/security.md +436 -0
- package/docs/serverless-guide.md +513 -0
- package/docs/skills-guide.md +857 -0
- package/docs/skills-system.md +301 -0
- package/docs/skills_parameter_schema.md +392 -0
- package/docs/skills_system.md +467 -0
- package/docs/swaig-reference.md +1627 -0
- package/docs/swaig_reference.md +910 -0
- package/docs/swml_service_guide.md +600 -0
- package/docs/third_party_skills.md +533 -0
- package/docs/web_service.md +677 -0
- package/examples/README.md +131 -0
- package/examples/advanced-datamap.ts +100 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +94 -0
- package/examples/call-flow.ts +63 -0
- package/examples/comprehensive-dynamic.ts +125 -0
- package/examples/contexts-steps.ts +65 -0
- package/examples/custom-path.ts +45 -0
- package/examples/datamap-tools.ts +55 -0
- package/examples/datasphere-multi-instance.ts +63 -0
- package/examples/datasphere-serverless-env.ts +68 -0
- package/examples/datasphere-webhook-env.ts +66 -0
- package/examples/datasphere.ts +37 -0
- package/examples/declarative.ts +100 -0
- package/examples/dynamic-config.ts +54 -0
- package/examples/dynamic-info-gatherer.ts +69 -0
- package/examples/dynamic-swml-service.ts +67 -0
- package/examples/gather-info.ts +71 -0
- package/examples/gather-per-question-functions-demo.ts +140 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +69 -0
- package/examples/mcp-agent.ts +84 -0
- package/examples/mcp-gateway.ts +35 -0
- package/examples/multi-agent.ts +73 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pom-prompt.ts +71 -0
- package/examples/prefab-concierge.ts +47 -0
- package/examples/prefab-faq.ts +54 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +68 -0
- package/examples/record-call.ts +67 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +94 -0
- package/examples/serverless-lambda.ts +35 -0
- package/examples/session-state.ts +83 -0
- package/examples/simple-agent.ts +36 -0
- package/examples/simple-static.ts +29 -0
- package/examples/skills-demo.ts +38 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +187 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/tap.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +72 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +140 -0
- package/livewire/docs/migration-guide.md +228 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +197 -0
- package/livewire/examples/livewire-multi-tool.ts +117 -0
- package/package.json +38 -0
- package/relay/README.md +70 -0
- package/relay/RELAY_IMPLEMENTATION_GUIDE.md +1257 -0
- package/relay/docs/call-methods.md +474 -0
- package/relay/docs/client-reference.md +142 -0
- package/relay/docs/events.md +134 -0
- package/relay/docs/getting-started.md +134 -0
- package/relay/docs/guide.md +306 -0
- package/relay/docs/messaging.md +182 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +71 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +95 -0
- package/rest/docs/calling.md +273 -0
- package/rest/docs/client-reference.md +107 -0
- package/rest/docs/compat.md +204 -0
- package/rest/docs/fabric.md +183 -0
- package/rest/docs/getting-started.md +110 -0
- package/rest/docs/guide.md +351 -0
- package/rest/docs/namespaces.md +285 -0
- package/rest/examples/rest-10dlc-registration.ts +161 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +102 -0
- package/rest/examples/rest-calling-play-and-record.ts +91 -0
- package/rest/examples/rest-client.ts +65 -0
- package/rest/examples/rest-compat-laml.ts +210 -0
- package/rest/examples/rest-datasphere-search.ts +82 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +144 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +108 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +99 -0
- package/rest/examples/rest-manage-resources.ts +65 -0
- package/rest/examples/rest-phone-number-management.ts +197 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/src/AgentBase.ts +2489 -0
- package/src/AgentServer.ts +415 -0
- package/src/AuthHandler.ts +256 -0
- package/src/ConfigLoader.ts +447 -0
- package/src/ContextBuilder.ts +1150 -0
- package/src/DataMap.ts +449 -0
- package/src/FunctionResult.ts +866 -0
- package/src/Logger.ts +337 -0
- package/src/PomBuilder.ts +439 -0
- package/src/PromptManager.ts +133 -0
- package/src/SWMLHandler.ts +298 -0
- package/src/SWMLService.ts +717 -0
- package/src/SchemaUtils.ts +361 -0
- package/src/SecurityUtils.ts +153 -0
- package/src/ServerlessAdapter.ts +221 -0
- package/src/SessionManager.ts +311 -0
- package/src/SslConfig.ts +118 -0
- package/src/SwaigFunction.ts +276 -0
- package/src/SwmlBuilder.ts +258 -0
- package/src/SwmlVerbMethods.generated.ts +234 -0
- package/src/TypeInference.ts +181 -0
- package/src/WebService.ts +619 -0
- package/src/cli/agent-loader.ts +166 -0
- package/src/cli/mock-data.ts +111 -0
- package/src/cli/swaig-test.ts +452 -0
- package/src/generateVerbTypes.ts +322 -0
- package/src/index.ts +167 -0
- package/src/livewire/index.ts +950 -0
- package/src/prefabs/ConciergeAgent.ts +287 -0
- package/src/prefabs/FAQBotAgent.ts +384 -0
- package/src/prefabs/InfoGathererAgent.ts +339 -0
- package/src/prefabs/ReceptionistAgent.ts +366 -0
- package/src/prefabs/SurveyAgent.ts +646 -0
- package/src/prefabs/index.ts +27 -0
- package/src/relay/Action.ts +314 -0
- package/src/relay/Call.ts +854 -0
- package/src/relay/Deferred.ts +71 -0
- package/src/relay/Message.ts +148 -0
- package/src/relay/RelayClient.ts +1036 -0
- package/src/relay/RelayError.ts +14 -0
- package/src/relay/RelayEvent.ts +892 -0
- package/src/relay/constants.ts +132 -0
- package/src/relay/index.ts +123 -0
- package/src/relay/types.ts +149 -0
- package/src/rest/HttpClient.ts +103 -0
- package/src/rest/RestError.ts +31 -0
- package/src/rest/base/BaseResource.ts +19 -0
- package/src/rest/base/CrudResource.ts +51 -0
- package/src/rest/base/CrudWithAddresses.ts +26 -0
- package/src/rest/index.ts +200 -0
- package/src/rest/namespaces/addresses.ts +32 -0
- package/src/rest/namespaces/calling.ts +187 -0
- package/src/rest/namespaces/chat.ts +20 -0
- package/src/rest/namespaces/compat.ts +352 -0
- package/src/rest/namespaces/datasphere.ts +45 -0
- package/src/rest/namespaces/fabric.ts +222 -0
- package/src/rest/namespaces/imported-numbers.ts +20 -0
- package/src/rest/namespaces/logs.ts +84 -0
- package/src/rest/namespaces/lookup.ts +21 -0
- package/src/rest/namespaces/mfa.ts +30 -0
- package/src/rest/namespaces/number-groups.ts +38 -0
- package/src/rest/namespaces/phone-numbers.ts +44 -0
- package/src/rest/namespaces/project.ts +36 -0
- package/src/rest/namespaces/pubsub.ts +20 -0
- package/src/rest/namespaces/queues.ts +33 -0
- package/src/rest/namespaces/recordings.ts +28 -0
- package/src/rest/namespaces/registry.ts +101 -0
- package/src/rest/namespaces/short-codes.ts +28 -0
- package/src/rest/namespaces/sip-profile.ts +25 -0
- package/src/rest/namespaces/verified-callers.ts +27 -0
- package/src/rest/namespaces/video.ts +165 -0
- package/src/rest/pagination.ts +84 -0
- package/src/rest/types.ts +61 -0
- package/src/schema.json +12250 -0
- package/src/skills/SkillBase.ts +547 -0
- package/src/skills/SkillManager.ts +415 -0
- package/src/skills/SkillRegistry.ts +367 -0
- package/src/skills/builtin/api_ninjas_trivia.ts +280 -0
- package/src/skills/builtin/ask_claude.ts +241 -0
- package/src/skills/builtin/claude_skills.ts +978 -0
- package/src/skills/builtin/custom_skills.ts +312 -0
- package/src/skills/builtin/datasphere.ts +438 -0
- package/src/skills/builtin/datasphere_serverless.ts +339 -0
- package/src/skills/builtin/datetime.ts +130 -0
- package/src/skills/builtin/google_maps.ts +651 -0
- package/src/skills/builtin/index.ts +88 -0
- package/src/skills/builtin/info_gatherer.ts +405 -0
- package/src/skills/builtin/joke.ts +191 -0
- package/src/skills/builtin/math.ts +142 -0
- package/src/skills/builtin/mcp_gateway.ts +677 -0
- package/src/skills/builtin/native_vector_search.ts +901 -0
- package/src/skills/builtin/play_background_file.ts +358 -0
- package/src/skills/builtin/spider.ts +869 -0
- package/src/skills/builtin/swml_transfer.ts +635 -0
- package/src/skills/builtin/weather_api.ts +248 -0
- package/src/skills/builtin/web_search.ts +1074 -0
- package/src/skills/builtin/wikipedia_search.ts +299 -0
- package/src/skills/index.ts +12 -0
- package/src/types.ts +132 -0
- package/tests/AgentBase.test.ts +1093 -0
- package/tests/AgentServer.test.ts +126 -0
- package/tests/AuthHandler.test.ts +133 -0
- package/tests/ConfigLoader.test.ts +151 -0
- package/tests/ContextBuilder.test.ts +108 -0
- package/tests/DataMap.test.ts +367 -0
- package/tests/EphemeralSkillCopy.test.ts +107 -0
- package/tests/FunctionResult.test.ts +298 -0
- package/tests/GracefulShutdown.test.ts +46 -0
- package/tests/Logger.test.ts +420 -0
- package/tests/PomBuilder.test.ts +228 -0
- package/tests/ProxyDetection.test.ts +228 -0
- package/tests/SWMLService.test.ts +320 -0
- package/tests/SWMLVerbHandler.test.ts +523 -0
- package/tests/SchemaUtils.test.ts +106 -0
- package/tests/SchemaUtils.verb.test.ts +206 -0
- package/tests/SecurityUtils.test.ts +192 -0
- package/tests/ServerlessAdapter.test.ts +222 -0
- package/tests/SessionManager.test.ts +257 -0
- package/tests/SkillBaseFeatures.test.ts +130 -0
- package/tests/SkillMultiInstance.test.ts +102 -0
- package/tests/SkillParameterSchemas.test.ts +134 -0
- package/tests/SkillRegistrySchema.test.ts +84 -0
- package/tests/SslConfig.test.ts +97 -0
- package/tests/SwmlBuilder.test.ts +400 -0
- package/tests/TypeInference.test.ts +165 -0
- package/tests/VerbHandlerRegistry.test.ts +128 -0
- package/tests/cli/mock-data.test.ts +113 -0
- package/tests/cli/swaig-test.test.ts +108 -0
- package/tests/examples.test.ts +194 -0
- package/tests/fixtures/scrape-parity/README.md +53 -0
- package/tests/fixtures/scrape-parity/expected/01_simple_article.json +5 -0
- package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +5 -0
- package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +5 -0
- package/tests/fixtures/scrape-parity/expected/04_bare_body.json +5 -0
- package/tests/fixtures/scrape-parity/expected/05_malformed.json +5 -0
- package/tests/fixtures/scrape-parity/expected/06_multi_class.json +5 -0
- package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +5 -0
- package/tests/fixtures/scrape-parity/expected/08_inline_script.json +5 -0
- package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +5 -0
- package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +5 -0
- package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +5 -0
- package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +5 -0
- package/tests/fixtures/scrape-parity/html/01_simple_article.html +18 -0
- package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +18 -0
- package/tests/fixtures/scrape-parity/html/03_nested_containers.html +13 -0
- package/tests/fixtures/scrape-parity/html/04_bare_body.html +9 -0
- package/tests/fixtures/scrape-parity/html/05_malformed.html +11 -0
- package/tests/fixtures/scrape-parity/html/06_multi_class.html +18 -0
- package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +12 -0
- package/tests/fixtures/scrape-parity/html/08_inline_script.html +17 -0
- package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +21 -0
- package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +10 -0
- package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +13 -0
- package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +24 -0
- package/tests/fixtures/scrape-parity/python_extract.py +109 -0
- package/tests/livewire/livewire.test.ts +780 -0
- package/tests/mcp.test.ts +221 -0
- package/tests/prefabs/prefabs.test.ts +1093 -0
- package/tests/relay/Action.test.ts +392 -0
- package/tests/relay/Call.test.ts +535 -0
- package/tests/relay/Deferred.test.ts +71 -0
- package/tests/relay/Message.test.ts +164 -0
- package/tests/relay/RelayClient.test.ts +779 -0
- package/tests/relay/RelayEvent.test.ts +463 -0
- package/tests/relay/helpers.ts +79 -0
- package/tests/rest/HttpClient.test.ts +274 -0
- package/tests/rest/RestError.test.ts +53 -0
- package/tests/rest/calling.test.ts +156 -0
- package/tests/rest/client.test.ts +197 -0
- package/tests/rest/compat.test.ts +335 -0
- package/tests/rest/datasphere.test.ts +71 -0
- package/tests/rest/fabric.test.ts +186 -0
- package/tests/rest/helpers.ts +95 -0
- package/tests/rest/logs.test.ts +68 -0
- package/tests/rest/pagination.test.ts +133 -0
- package/tests/rest/registry.test.ts +94 -0
- package/tests/rest/relay-rest.test.ts +290 -0
- package/tests/rest/video.test.ts +173 -0
- package/tests/setup.ts +6 -0
- package/tests/skills/SkillBase.test.ts +108 -0
- package/tests/skills/SkillManager.test.ts +268 -0
- package/tests/skills/SkillRegistry.test.ts +176 -0
- package/tests/skills/builtin.test.ts +1472 -0
- package/tests/skills/claude-skills.test.ts +54 -0
- package/tests/skills/custom-skills.test.ts +53 -0
- package/tests/skills/datasphere-serverless.test.ts +70 -0
- package/tests/skills/datasphere.test.ts +107 -0
- package/tests/skills/datetime.test.ts +101 -0
- package/tests/skills/google-maps.test.ts +78 -0
- package/tests/skills/info-gatherer.test.ts +411 -0
- package/tests/skills/joke.test.ts +81 -0
- package/tests/skills/math.test.ts +68 -0
- package/tests/skills/mcp-gateway.test.ts +101 -0
- package/tests/skills/play-background.test.ts +54 -0
- package/tests/skills/spider.test.ts +108 -0
- package/tests/skills/swml-transfer.test.ts +178 -0
- package/tests/skills/trivia.test.ts +54 -0
- package/tests/skills/vector-search.test.ts +135 -0
- package/tests/skills/weather-api.test.ts +77 -0
- package/tests/skills/web-search-parity.test.ts +59 -0
- package/tests/skills/web-search.test.ts +103 -0
- package/tests/skills/wikipedia.test.ts +63 -0
- package/tsconfig.json +18 -0
- package/vitest.config.ts +9 -0
|
@@ -0,0 +1,420 @@
|
|
|
1
|
+
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
|
|
2
|
+
import { Logger, getLogger, setGlobalLogLevel, suppressAllLogs, setGlobalLogFormat, setGlobalLogColor, setGlobalLogStream, resetLoggingConfiguration, getExecutionMode } from '../src/Logger.js';
|
|
3
|
+
|
|
4
|
+
describe('Logger', () => {
|
|
5
|
+
let spyDebug: ReturnType<typeof vi.spyOn>;
|
|
6
|
+
let spyInfo: ReturnType<typeof vi.spyOn>;
|
|
7
|
+
let spyWarn: ReturnType<typeof vi.spyOn>;
|
|
8
|
+
let spyError: ReturnType<typeof vi.spyOn>;
|
|
9
|
+
|
|
10
|
+
beforeEach(() => {
|
|
11
|
+
spyDebug = vi.spyOn(console, 'debug').mockImplementation(() => {});
|
|
12
|
+
spyInfo = vi.spyOn(console, 'info').mockImplementation(() => {});
|
|
13
|
+
spyWarn = vi.spyOn(console, 'warn').mockImplementation(() => {});
|
|
14
|
+
spyError = vi.spyOn(console, 'error').mockImplementation(() => {});
|
|
15
|
+
setGlobalLogLevel('debug');
|
|
16
|
+
setGlobalLogColor(false);
|
|
17
|
+
setGlobalLogFormat('text');
|
|
18
|
+
setGlobalLogStream('stdout');
|
|
19
|
+
suppressAllLogs(false);
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
afterEach(() => {
|
|
23
|
+
vi.restoreAllMocks();
|
|
24
|
+
// Clean up env vars that tests may set
|
|
25
|
+
delete process.env['GATEWAY_INTERFACE'];
|
|
26
|
+
delete process.env['AWS_LAMBDA_FUNCTION_NAME'];
|
|
27
|
+
delete process.env['LAMBDA_TASK_ROOT'];
|
|
28
|
+
delete process.env['FUNCTION_TARGET'];
|
|
29
|
+
delete process.env['K_SERVICE'];
|
|
30
|
+
delete process.env['GOOGLE_CLOUD_PROJECT'];
|
|
31
|
+
delete process.env['AZURE_FUNCTIONS_ENVIRONMENT'];
|
|
32
|
+
delete process.env['FUNCTIONS_WORKER_RUNTIME'];
|
|
33
|
+
setGlobalLogLevel('info');
|
|
34
|
+
setGlobalLogFormat('text');
|
|
35
|
+
setGlobalLogColor(false);
|
|
36
|
+
setGlobalLogStream('stdout');
|
|
37
|
+
suppressAllLogs(false);
|
|
38
|
+
resetLoggingConfiguration();
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
it('getLogger returns Logger instance', () => {
|
|
42
|
+
const log = getLogger('test-unique-1');
|
|
43
|
+
expect(log).toBeInstanceOf(Logger);
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
it('logs at debug level with timestamp', () => {
|
|
47
|
+
const log = new Logger('mymod');
|
|
48
|
+
log.debug('hello');
|
|
49
|
+
const output = spyDebug.mock.calls[0][0] as string;
|
|
50
|
+
expect(output).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/);
|
|
51
|
+
expect(output).toContain('[DEBUG] [mymod] hello');
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
it('logs at info level with timestamp', () => {
|
|
55
|
+
const log = new Logger('mymod');
|
|
56
|
+
log.info('world');
|
|
57
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
58
|
+
expect(output).toMatch(/^\d{4}-\d{2}-\d{2}T/);
|
|
59
|
+
expect(output).toContain('[INFO] [mymod] world');
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
it('logs at warn level', () => {
|
|
63
|
+
const log = new Logger('mymod');
|
|
64
|
+
log.warn('caution');
|
|
65
|
+
const output = spyWarn.mock.calls[0][0] as string;
|
|
66
|
+
expect(output).toContain('[WARN] [mymod] caution');
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
it('logs at error level', () => {
|
|
70
|
+
const log = new Logger('mymod');
|
|
71
|
+
log.error('failure');
|
|
72
|
+
const output = spyError.mock.calls[0][0] as string;
|
|
73
|
+
expect(output).toContain('[ERROR] [mymod] failure');
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
it('includes data as key=value pairs in text output', () => {
|
|
77
|
+
const log = new Logger('test');
|
|
78
|
+
log.info('msg', { key: 'val' });
|
|
79
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
80
|
+
expect(output).toContain('key=val');
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
it('respects log level filtering', () => {
|
|
84
|
+
setGlobalLogLevel('warn');
|
|
85
|
+
const log = new Logger('test');
|
|
86
|
+
log.debug('hidden');
|
|
87
|
+
log.info('hidden');
|
|
88
|
+
log.warn('shown');
|
|
89
|
+
log.error('shown');
|
|
90
|
+
expect(spyDebug).not.toHaveBeenCalled();
|
|
91
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
92
|
+
expect(spyWarn).toHaveBeenCalledOnce();
|
|
93
|
+
expect(spyError).toHaveBeenCalledOnce();
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
it('setGlobalLogLevel changes level', () => {
|
|
97
|
+
setGlobalLogLevel('error');
|
|
98
|
+
const log = new Logger('test');
|
|
99
|
+
log.warn('nope');
|
|
100
|
+
log.error('yes');
|
|
101
|
+
expect(spyWarn).not.toHaveBeenCalled();
|
|
102
|
+
expect(spyError).toHaveBeenCalledOnce();
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
it('suppressAllLogs suppresses everything', () => {
|
|
106
|
+
suppressAllLogs(true);
|
|
107
|
+
const log = new Logger('test');
|
|
108
|
+
log.debug('nope');
|
|
109
|
+
log.info('nope');
|
|
110
|
+
log.warn('nope');
|
|
111
|
+
log.error('nope');
|
|
112
|
+
expect(spyDebug).not.toHaveBeenCalled();
|
|
113
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
114
|
+
expect(spyWarn).not.toHaveBeenCalled();
|
|
115
|
+
expect(spyError).not.toHaveBeenCalled();
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
it('suppressAllLogs can be turned off', () => {
|
|
119
|
+
suppressAllLogs(true);
|
|
120
|
+
const log = new Logger('test');
|
|
121
|
+
log.info('hidden');
|
|
122
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
123
|
+
suppressAllLogs(false);
|
|
124
|
+
log.info('shown');
|
|
125
|
+
expect(spyInfo).toHaveBeenCalledOnce();
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
it('empty data object does not append to output', () => {
|
|
129
|
+
const log = new Logger('test');
|
|
130
|
+
log.info('clean', {});
|
|
131
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
132
|
+
expect(output).toContain('[INFO] [test] clean');
|
|
133
|
+
// Should not have trailing key=value data
|
|
134
|
+
expect(output.endsWith('clean')).toBe(true);
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
it('debug level shows all messages', () => {
|
|
138
|
+
setGlobalLogLevel('debug');
|
|
139
|
+
const log = new Logger('test');
|
|
140
|
+
log.debug('d');
|
|
141
|
+
log.info('i');
|
|
142
|
+
log.warn('w');
|
|
143
|
+
log.error('e');
|
|
144
|
+
expect(spyDebug).toHaveBeenCalledOnce();
|
|
145
|
+
expect(spyInfo).toHaveBeenCalledOnce();
|
|
146
|
+
expect(spyWarn).toHaveBeenCalledOnce();
|
|
147
|
+
expect(spyError).toHaveBeenCalledOnce();
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
// ── Pass 2: New logger features ──────────────────────────────────
|
|
151
|
+
|
|
152
|
+
it('JSON format outputs structured JSON', () => {
|
|
153
|
+
setGlobalLogFormat('json');
|
|
154
|
+
const log = new Logger('mymod');
|
|
155
|
+
log.info('hello world');
|
|
156
|
+
expect(spyInfo).toHaveBeenCalledOnce();
|
|
157
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
158
|
+
const parsed = JSON.parse(output);
|
|
159
|
+
expect(parsed.level).toBe('info');
|
|
160
|
+
expect(parsed.logger).toBe('mymod');
|
|
161
|
+
expect(parsed.message).toBe('hello world');
|
|
162
|
+
expect(parsed.timestamp).toBeDefined();
|
|
163
|
+
});
|
|
164
|
+
|
|
165
|
+
it('JSON format includes data fields', () => {
|
|
166
|
+
setGlobalLogFormat('json');
|
|
167
|
+
const log = new Logger('test');
|
|
168
|
+
log.warn('alert', { code: 500, path: '/api' });
|
|
169
|
+
const output = spyWarn.mock.calls[0][0] as string;
|
|
170
|
+
const parsed = JSON.parse(output);
|
|
171
|
+
expect(parsed.code).toBe(500);
|
|
172
|
+
expect(parsed.path).toBe('/api');
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
it('bind creates child logger with context', () => {
|
|
176
|
+
const log = new Logger('test');
|
|
177
|
+
const child = log.bind({ callId: 'call-42', function: 'get_time' });
|
|
178
|
+
child.info('processing');
|
|
179
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
180
|
+
expect(output).toContain('callId=call-42');
|
|
181
|
+
expect(output).toContain('function=get_time');
|
|
182
|
+
});
|
|
183
|
+
|
|
184
|
+
it('bind context merges with log data', () => {
|
|
185
|
+
const log = new Logger('test').bind({ callId: 'c1' });
|
|
186
|
+
log.info('msg', { extra: true });
|
|
187
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
188
|
+
expect(output).toContain('callId=c1');
|
|
189
|
+
expect(output).toContain('extra=true');
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
it('bind context can be chained', () => {
|
|
193
|
+
const log = new Logger('test')
|
|
194
|
+
.bind({ callId: 'c1' })
|
|
195
|
+
.bind({ step: 'auth' });
|
|
196
|
+
log.info('ok');
|
|
197
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
198
|
+
expect(output).toContain('callId=c1');
|
|
199
|
+
expect(output).toContain('step=auth');
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
it('color output includes ANSI codes', () => {
|
|
203
|
+
setGlobalLogColor(true);
|
|
204
|
+
const log = new Logger('test');
|
|
205
|
+
log.info('colorful');
|
|
206
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
207
|
+
expect(output).toContain('\x1b[32m'); // green for info
|
|
208
|
+
expect(output).toContain('\x1b[0m'); // reset
|
|
209
|
+
});
|
|
210
|
+
|
|
211
|
+
it('no ANSI codes when color disabled', () => {
|
|
212
|
+
setGlobalLogColor(false);
|
|
213
|
+
const log = new Logger('test');
|
|
214
|
+
log.error('plain');
|
|
215
|
+
const output = spyError.mock.calls[0][0] as string;
|
|
216
|
+
expect(output).not.toContain('\x1b[');
|
|
217
|
+
});
|
|
218
|
+
|
|
219
|
+
it('resetLoggingConfiguration restores defaults', () => {
|
|
220
|
+
setGlobalLogLevel('error');
|
|
221
|
+
setGlobalLogFormat('json');
|
|
222
|
+
suppressAllLogs(true);
|
|
223
|
+
resetLoggingConfiguration();
|
|
224
|
+
// After reset, should use env vars or defaults
|
|
225
|
+
const log = new Logger('test');
|
|
226
|
+
log.info('after reset');
|
|
227
|
+
// Since logs were re-enabled and level reset to 'info', this should log
|
|
228
|
+
expect(spyInfo).toHaveBeenCalledOnce();
|
|
229
|
+
});
|
|
230
|
+
|
|
231
|
+
it('JSON format in bind context', () => {
|
|
232
|
+
setGlobalLogFormat('json');
|
|
233
|
+
const log = new Logger('test').bind({ reqId: 'r1' });
|
|
234
|
+
log.debug('check');
|
|
235
|
+
const output = spyDebug.mock.calls[0][0] as string;
|
|
236
|
+
const parsed = JSON.parse(output);
|
|
237
|
+
expect(parsed.reqId).toBe('r1');
|
|
238
|
+
expect(parsed.message).toBe('check');
|
|
239
|
+
});
|
|
240
|
+
|
|
241
|
+
// ── Pass 3: Logging parity features ──────────────────────────────
|
|
242
|
+
|
|
243
|
+
it('timestamp appears in text output as ISO format prefix', () => {
|
|
244
|
+
const log = new Logger('ts-test');
|
|
245
|
+
log.info('check');
|
|
246
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
247
|
+
// ISO timestamp: 2025-01-15T10:30:00.000Z
|
|
248
|
+
expect(output).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z/);
|
|
249
|
+
});
|
|
250
|
+
|
|
251
|
+
it('stderr mode routes all levels through console.error', () => {
|
|
252
|
+
setGlobalLogStream('stderr');
|
|
253
|
+
const log = new Logger('stderr-test');
|
|
254
|
+
log.debug('d');
|
|
255
|
+
log.info('i');
|
|
256
|
+
log.warn('w');
|
|
257
|
+
log.error('e');
|
|
258
|
+
expect(spyError).toHaveBeenCalledTimes(4);
|
|
259
|
+
expect(spyDebug).not.toHaveBeenCalled();
|
|
260
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
261
|
+
expect(spyWarn).not.toHaveBeenCalled();
|
|
262
|
+
});
|
|
263
|
+
|
|
264
|
+
it('auto mode with GATEWAY_INTERFACE suppresses logging', () => {
|
|
265
|
+
process.env['GATEWAY_INTERFACE'] = 'CGI/1.1';
|
|
266
|
+
resetLoggingConfiguration();
|
|
267
|
+
setGlobalLogLevel('debug');
|
|
268
|
+
const log = new Logger('cgi-test');
|
|
269
|
+
log.info('should be suppressed');
|
|
270
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
271
|
+
expect(spyError).not.toHaveBeenCalled();
|
|
272
|
+
});
|
|
273
|
+
|
|
274
|
+
it('auto mode with AWS_LAMBDA_FUNCTION_NAME uses stderr', () => {
|
|
275
|
+
process.env['AWS_LAMBDA_FUNCTION_NAME'] = 'my-func';
|
|
276
|
+
resetLoggingConfiguration();
|
|
277
|
+
setGlobalLogLevel('debug');
|
|
278
|
+
const log = new Logger('lambda-test');
|
|
279
|
+
log.info('lambda log');
|
|
280
|
+
// In stderr mode, all output goes through console.error
|
|
281
|
+
expect(spyError).toHaveBeenCalledOnce();
|
|
282
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
283
|
+
});
|
|
284
|
+
|
|
285
|
+
it('Error objects in data are serialized with message and stack', () => {
|
|
286
|
+
const err = new Error('test error');
|
|
287
|
+
const log = new Logger('err-test');
|
|
288
|
+
setGlobalLogFormat('json');
|
|
289
|
+
log.error('failed', { error: err });
|
|
290
|
+
const output = spyError.mock.calls[0][0] as string;
|
|
291
|
+
const parsed = JSON.parse(output);
|
|
292
|
+
expect(parsed.error).toBeDefined();
|
|
293
|
+
expect(parsed.error.message).toBe('test error');
|
|
294
|
+
expect(parsed.error.name).toBe('Error');
|
|
295
|
+
expect(parsed.error.stack).toBeDefined();
|
|
296
|
+
});
|
|
297
|
+
|
|
298
|
+
it('Error objects in text mode are serialized as JSON in key=value output', () => {
|
|
299
|
+
const err = new Error('oops');
|
|
300
|
+
const log = new Logger('err-test');
|
|
301
|
+
log.error('failed', { error: err });
|
|
302
|
+
const output = spyError.mock.calls[0][0] as string;
|
|
303
|
+
// Error should be serialized as an object, shown as JSON value
|
|
304
|
+
expect(output).toContain('error=');
|
|
305
|
+
expect(output).toContain('"message":"oops"');
|
|
306
|
+
});
|
|
307
|
+
|
|
308
|
+
it('Logger caching: getLogger returns same instance for same name', () => {
|
|
309
|
+
resetLoggingConfiguration();
|
|
310
|
+
const a = getLogger('cached-test');
|
|
311
|
+
const b = getLogger('cached-test');
|
|
312
|
+
expect(a).toBe(b);
|
|
313
|
+
});
|
|
314
|
+
|
|
315
|
+
it('Logger caching: different names return different instances', () => {
|
|
316
|
+
resetLoggingConfiguration();
|
|
317
|
+
const a = getLogger('cache-a');
|
|
318
|
+
const b = getLogger('cache-b');
|
|
319
|
+
expect(a).not.toBe(b);
|
|
320
|
+
});
|
|
321
|
+
|
|
322
|
+
it('resetLoggingConfiguration clears logger cache', () => {
|
|
323
|
+
const a = getLogger('cache-clear-test');
|
|
324
|
+
resetLoggingConfiguration();
|
|
325
|
+
const b = getLogger('cache-clear-test');
|
|
326
|
+
expect(a).not.toBe(b);
|
|
327
|
+
});
|
|
328
|
+
|
|
329
|
+
it('key=value text formatting for simple data', () => {
|
|
330
|
+
const log = new Logger('kv-test');
|
|
331
|
+
log.info('op', { count: 5, status: 'ok' });
|
|
332
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
333
|
+
expect(output).toContain('count=5');
|
|
334
|
+
expect(output).toContain('status=ok');
|
|
335
|
+
});
|
|
336
|
+
|
|
337
|
+
it('quoted values for strings with spaces', () => {
|
|
338
|
+
const log = new Logger('kv-test');
|
|
339
|
+
log.info('op', { msg: 'hello world' });
|
|
340
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
341
|
+
expect(output).toContain('msg="hello world"');
|
|
342
|
+
});
|
|
343
|
+
|
|
344
|
+
it('nested objects use JSON in key=value mode', () => {
|
|
345
|
+
const log = new Logger('kv-test');
|
|
346
|
+
log.info('op', { nested: { a: 1 } });
|
|
347
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
348
|
+
expect(output).toContain('nested={"a":1}');
|
|
349
|
+
});
|
|
350
|
+
|
|
351
|
+
it('arrays use JSON in key=value mode', () => {
|
|
352
|
+
const log = new Logger('kv-test');
|
|
353
|
+
log.info('op', { items: [1, 2, 3] });
|
|
354
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
355
|
+
expect(output).toContain('items=[1,2,3]');
|
|
356
|
+
});
|
|
357
|
+
|
|
358
|
+
it('color mode includes DIM timestamp', () => {
|
|
359
|
+
setGlobalLogColor(true);
|
|
360
|
+
const log = new Logger('color-ts');
|
|
361
|
+
log.info('check');
|
|
362
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
363
|
+
expect(output).toContain('\x1b[2m'); // DIM for timestamp
|
|
364
|
+
expect(output).toContain('\x1b[32m'); // green for INFO
|
|
365
|
+
});
|
|
366
|
+
|
|
367
|
+
it('getExecutionMode returns server by default', () => {
|
|
368
|
+
const [env, mode] = getExecutionMode();
|
|
369
|
+
expect(env).toBe('server');
|
|
370
|
+
expect(mode).toBe('default');
|
|
371
|
+
});
|
|
372
|
+
|
|
373
|
+
it('getExecutionMode detects CGI', () => {
|
|
374
|
+
process.env['GATEWAY_INTERFACE'] = 'CGI/1.1';
|
|
375
|
+
const [env, mode] = getExecutionMode();
|
|
376
|
+
expect(env).toBe('cgi');
|
|
377
|
+
expect(mode).toBe('off');
|
|
378
|
+
});
|
|
379
|
+
|
|
380
|
+
it('getExecutionMode detects Lambda', () => {
|
|
381
|
+
process.env['AWS_LAMBDA_FUNCTION_NAME'] = 'test-fn';
|
|
382
|
+
const [env, mode] = getExecutionMode();
|
|
383
|
+
expect(env).toBe('lambda');
|
|
384
|
+
expect(mode).toBe('stderr');
|
|
385
|
+
});
|
|
386
|
+
|
|
387
|
+
it('getExecutionMode detects Google Cloud', () => {
|
|
388
|
+
process.env['K_SERVICE'] = 'my-service';
|
|
389
|
+
const [env, mode] = getExecutionMode();
|
|
390
|
+
expect(env).toBe('google_cloud_function');
|
|
391
|
+
expect(mode).toBe('default');
|
|
392
|
+
});
|
|
393
|
+
|
|
394
|
+
it('getExecutionMode detects Azure', () => {
|
|
395
|
+
process.env['AZURE_FUNCTIONS_ENVIRONMENT'] = 'Production';
|
|
396
|
+
const [env, mode] = getExecutionMode();
|
|
397
|
+
expect(env).toBe('azure_function');
|
|
398
|
+
expect(mode).toBe('default');
|
|
399
|
+
});
|
|
400
|
+
|
|
401
|
+
it('stderr mode routes JSON output through console.error too', () => {
|
|
402
|
+
setGlobalLogFormat('json');
|
|
403
|
+
setGlobalLogStream('stderr');
|
|
404
|
+
const log = new Logger('stderr-json');
|
|
405
|
+
log.info('json msg');
|
|
406
|
+
expect(spyError).toHaveBeenCalledOnce();
|
|
407
|
+
expect(spyInfo).not.toHaveBeenCalled();
|
|
408
|
+
const output = spyError.mock.calls[0][0] as string;
|
|
409
|
+
const parsed = JSON.parse(output);
|
|
410
|
+
expect(parsed.message).toBe('json msg');
|
|
411
|
+
});
|
|
412
|
+
|
|
413
|
+
it('null and undefined values are rendered in key=value mode', () => {
|
|
414
|
+
const log = new Logger('kv-test');
|
|
415
|
+
log.info('op', { a: null as any, b: undefined as any });
|
|
416
|
+
const output = spyInfo.mock.calls[0][0] as string;
|
|
417
|
+
expect(output).toContain('a=null');
|
|
418
|
+
expect(output).toContain('b=undefined');
|
|
419
|
+
});
|
|
420
|
+
});
|
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { PomBuilder, PomSection } from '../src/PomBuilder.js';
|
|
3
|
+
import { SwmlBuilder } from '../src/SwmlBuilder.js';
|
|
4
|
+
|
|
5
|
+
describe('PomSection', () => {
|
|
6
|
+
it('toDict includes only non-empty fields', () => {
|
|
7
|
+
const s = new PomSection({ title: 'Hello', body: 'World' });
|
|
8
|
+
const d = s.toDict();
|
|
9
|
+
expect(d.title).toBe('Hello');
|
|
10
|
+
expect(d.body).toBe('World');
|
|
11
|
+
expect(d.bullets).toBeUndefined();
|
|
12
|
+
expect(d.subsections).toBeUndefined();
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
it('renderMarkdown produces heading + body', () => {
|
|
16
|
+
const s = new PomSection({ title: 'Title', body: 'Body text' });
|
|
17
|
+
const md = s.renderMarkdown();
|
|
18
|
+
expect(md).toContain('## Title');
|
|
19
|
+
expect(md).toContain('Body text');
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
it('renderMarkdown with bullets', () => {
|
|
23
|
+
const s = new PomSection({ title: 'T', bullets: ['a', 'b'] });
|
|
24
|
+
const md = s.renderMarkdown();
|
|
25
|
+
expect(md).toContain('- a');
|
|
26
|
+
expect(md).toContain('- b');
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
it('renderMarkdown with numbered bullets', () => {
|
|
30
|
+
const s = new PomSection({ title: 'T', bullets: ['a', 'b'], numberedBullets: true });
|
|
31
|
+
const md = s.renderMarkdown();
|
|
32
|
+
expect(md).toContain('1. a');
|
|
33
|
+
expect(md).toContain('2. b');
|
|
34
|
+
});
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
describe('PomBuilder', () => {
|
|
38
|
+
it('addSection and toDict', () => {
|
|
39
|
+
const b = new PomBuilder()
|
|
40
|
+
.addSection('Role', { body: 'You are a helper' })
|
|
41
|
+
.addSection('Rules', { bullets: ['Be nice', 'Be helpful'] });
|
|
42
|
+
|
|
43
|
+
const dict = b.toDict();
|
|
44
|
+
expect(dict.length).toBe(2);
|
|
45
|
+
expect(dict[0].title).toBe('Role');
|
|
46
|
+
expect(dict[0].body).toBe('You are a helper');
|
|
47
|
+
expect(dict[1].bullets).toEqual(['Be nice', 'Be helpful']);
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
it('addToSection creates section if missing', () => {
|
|
51
|
+
const b = new PomBuilder().addToSection('New', { body: 'hello' });
|
|
52
|
+
expect(b.hasSection('New')).toBe(true);
|
|
53
|
+
expect(b.toDict()[0].body).toBe('hello');
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
it('addToSection appends body', () => {
|
|
57
|
+
const b = new PomBuilder()
|
|
58
|
+
.addSection('S', { body: 'line1' })
|
|
59
|
+
.addToSection('S', { body: 'line2' });
|
|
60
|
+
expect(b.getSection('S')!.body).toBe('line1\n\nline2');
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it('addToSection appends bullets', () => {
|
|
64
|
+
const b = new PomBuilder()
|
|
65
|
+
.addSection('S', { bullets: ['a'] })
|
|
66
|
+
.addToSection('S', { bullet: 'b' })
|
|
67
|
+
.addToSection('S', { bullets: ['c', 'd'] });
|
|
68
|
+
expect(b.getSection('S')!.bullets).toEqual(['a', 'b', 'c', 'd']);
|
|
69
|
+
});
|
|
70
|
+
|
|
71
|
+
it('addSubsection', () => {
|
|
72
|
+
const b = new PomBuilder()
|
|
73
|
+
.addSection('Parent')
|
|
74
|
+
.addSubsection('Parent', 'Child', { body: 'child body' });
|
|
75
|
+
|
|
76
|
+
const dict = b.toDict();
|
|
77
|
+
expect(dict[0].subsections!.length).toBe(1);
|
|
78
|
+
expect(dict[0].subsections![0].title).toBe('Child');
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
it('addSubsection auto-creates parent', () => {
|
|
82
|
+
const b = new PomBuilder().addSubsection('P', 'C', { body: 'x' });
|
|
83
|
+
expect(b.hasSection('P')).toBe(true);
|
|
84
|
+
expect(b.toDict()[0].subsections![0].title).toBe('C');
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
it('hasSection / getSection / findSection', () => {
|
|
88
|
+
const b = new PomBuilder()
|
|
89
|
+
.addSection('Top')
|
|
90
|
+
.addSubsection('Top', 'Nested', { body: 'x' });
|
|
91
|
+
|
|
92
|
+
expect(b.hasSection('Top')).toBe(true);
|
|
93
|
+
expect(b.hasSection('Missing')).toBe(false);
|
|
94
|
+
expect(b.getSection('Top')).toBeDefined();
|
|
95
|
+
expect(b.findSection('Nested')).toBeDefined();
|
|
96
|
+
expect(b.findSection('Missing')).toBeUndefined();
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
it('renderMarkdown produces valid markdown', () => {
|
|
100
|
+
const b = new PomBuilder()
|
|
101
|
+
.addSection('Persona', { body: 'You are helpful' })
|
|
102
|
+
.addSection('Rules', { bullets: ['Be nice', 'Be clear'] });
|
|
103
|
+
|
|
104
|
+
const md = b.renderMarkdown();
|
|
105
|
+
expect(md).toContain('## Persona');
|
|
106
|
+
expect(md).toContain('You are helpful');
|
|
107
|
+
expect(md).toContain('## Rules');
|
|
108
|
+
expect(md).toContain('- Be nice');
|
|
109
|
+
});
|
|
110
|
+
|
|
111
|
+
it('addSection with subsections in options', () => {
|
|
112
|
+
const b = new PomBuilder().addSection('Root', {
|
|
113
|
+
body: 'root body',
|
|
114
|
+
subsections: [
|
|
115
|
+
{ title: 'Sub1', body: 'sub1 body' },
|
|
116
|
+
{ title: 'Sub2', bullets: ['x'] },
|
|
117
|
+
],
|
|
118
|
+
});
|
|
119
|
+
const dict = b.toDict();
|
|
120
|
+
expect(dict[0].subsections!.length).toBe(2);
|
|
121
|
+
});
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
describe('addPomAsSubsection', () => {
|
|
125
|
+
it('appends sections of another PomBuilder by target title', () => {
|
|
126
|
+
const target = new PomBuilder().addSection('Parent', { body: 'parent body' });
|
|
127
|
+
const other = new PomBuilder()
|
|
128
|
+
.addSection('Child A', { body: 'a' })
|
|
129
|
+
.addSection('Child B', { bullets: ['x', 'y'] });
|
|
130
|
+
|
|
131
|
+
target.addPomAsSubsection('Parent', other);
|
|
132
|
+
|
|
133
|
+
const parent = target.getSection('Parent')!;
|
|
134
|
+
expect(parent.subsections.length).toBe(2);
|
|
135
|
+
expect(parent.subsections[0].title).toBe('Child A');
|
|
136
|
+
expect(parent.subsections[0].body).toBe('a');
|
|
137
|
+
expect(parent.subsections[1].title).toBe('Child B');
|
|
138
|
+
expect(parent.subsections[1].bullets).toEqual(['x', 'y']);
|
|
139
|
+
});
|
|
140
|
+
|
|
141
|
+
it('appends sections when target is a PomSection reference', () => {
|
|
142
|
+
const target = new PomBuilder().addSection('Parent');
|
|
143
|
+
const parent = target.getSection('Parent')!;
|
|
144
|
+
const other = new PomBuilder()
|
|
145
|
+
.addSection('One')
|
|
146
|
+
.addSection('Two');
|
|
147
|
+
|
|
148
|
+
target.addPomAsSubsection(parent, other);
|
|
149
|
+
|
|
150
|
+
expect(parent.subsections.length).toBe(2);
|
|
151
|
+
expect(parent.subsections[0].title).toBe('One');
|
|
152
|
+
expect(parent.subsections[1].title).toBe('Two');
|
|
153
|
+
});
|
|
154
|
+
|
|
155
|
+
it('throws when target title does not match any section', () => {
|
|
156
|
+
const target = new PomBuilder().addSection('Exists');
|
|
157
|
+
const other = new PomBuilder().addSection('Anything');
|
|
158
|
+
|
|
159
|
+
expect(() => target.addPomAsSubsection('Missing', other)).toThrow(
|
|
160
|
+
"No section with title 'Missing' found.",
|
|
161
|
+
);
|
|
162
|
+
});
|
|
163
|
+
|
|
164
|
+
it('preserves order and count of appended sections', () => {
|
|
165
|
+
const target = new PomBuilder().addSection('Parent');
|
|
166
|
+
const other = new PomBuilder()
|
|
167
|
+
.addSection('First')
|
|
168
|
+
.addSection('Second')
|
|
169
|
+
.addSection('Third');
|
|
170
|
+
|
|
171
|
+
target.addPomAsSubsection('Parent', other);
|
|
172
|
+
|
|
173
|
+
const parent = target.getSection('Parent')!;
|
|
174
|
+
expect(parent.subsections.length).toBe(3);
|
|
175
|
+
expect(parent.subsections.map((s) => s.title)).toEqual(['First', 'Second', 'Third']);
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
it('returns this for fluent chaining', () => {
|
|
179
|
+
const builder = new PomBuilder().addSection('Parent');
|
|
180
|
+
const other = new PomBuilder().addSection('Child');
|
|
181
|
+
|
|
182
|
+
const result = builder.addPomAsSubsection('Parent', other);
|
|
183
|
+
|
|
184
|
+
expect(result).toBe(builder);
|
|
185
|
+
});
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
describe('SwmlBuilder', () => {
|
|
189
|
+
it('creates empty document', () => {
|
|
190
|
+
const b = new SwmlBuilder();
|
|
191
|
+
const doc = b.getDocument();
|
|
192
|
+
expect(doc['version']).toBe('1.0.0');
|
|
193
|
+
expect((doc['sections'] as Record<string, unknown[]>)['main']).toEqual([]);
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
it('addVerb', () => {
|
|
197
|
+
const b = new SwmlBuilder();
|
|
198
|
+
b.addVerb('answer', {});
|
|
199
|
+
b.addVerb('ai', { prompt: { text: 'hello' } });
|
|
200
|
+
const main = (b.getDocument()['sections'] as Record<string, unknown[]>)['main'];
|
|
201
|
+
expect(main.length).toBe(2);
|
|
202
|
+
expect(main[0]).toEqual({ answer: {} });
|
|
203
|
+
});
|
|
204
|
+
|
|
205
|
+
it('addVerbToSection creates section', () => {
|
|
206
|
+
const b = new SwmlBuilder();
|
|
207
|
+
b.addVerbToSection('custom', 'play', { url: 'test.mp3' });
|
|
208
|
+
const sections = b.getDocument()['sections'] as Record<string, unknown[]>;
|
|
209
|
+
expect(sections['custom']).toBeDefined();
|
|
210
|
+
expect(sections['custom'][0]).toEqual({ play: { url: 'test.mp3' } });
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
it('reset clears document', () => {
|
|
214
|
+
const b = new SwmlBuilder();
|
|
215
|
+
b.addVerb('answer', {});
|
|
216
|
+
b.reset();
|
|
217
|
+
const main = (b.getDocument()['sections'] as Record<string, unknown[]>)['main'];
|
|
218
|
+
expect(main).toEqual([]);
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
it('renderDocument returns JSON', () => {
|
|
222
|
+
const b = new SwmlBuilder();
|
|
223
|
+
b.addVerb('answer', {});
|
|
224
|
+
const json = b.renderDocument();
|
|
225
|
+
const parsed = JSON.parse(json);
|
|
226
|
+
expect(parsed.version).toBe('1.0.0');
|
|
227
|
+
});
|
|
228
|
+
});
|