@lssm/lib.personalization 0.0.0-canary-20251220030446 → 0.0.0-canary-20251221114240
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.
|
@@ -3,8 +3,8 @@ import { registerDocBlocks } from "../../registry.js";
|
|
|
3
3
|
//#region ../contracts/dist/docs/tech/contracts/openapi-export.docblock.js
|
|
4
4
|
const tech_contracts_openapi_export_DocBlocks = [{
|
|
5
5
|
id: "docs.tech.contracts.openapi-export",
|
|
6
|
-
title: "OpenAPI export (OpenAPI 3.1) from
|
|
7
|
-
summary: "Generate a deterministic OpenAPI document from a
|
|
6
|
+
title: "OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry",
|
|
7
|
+
summary: "Generate a deterministic OpenAPI document from a OperationSpecRegistry using jsonSchemaForSpec + REST transport metadata.",
|
|
8
8
|
kind: "reference",
|
|
9
9
|
visibility: "public",
|
|
10
10
|
route: "/docs/tech/contracts/openapi-export",
|
|
@@ -13,7 +13,7 @@ const tech_contracts_openapi_export_DocBlocks = [{
|
|
|
13
13
|
"openapi",
|
|
14
14
|
"rest"
|
|
15
15
|
],
|
|
16
|
-
body: `## OpenAPI export (OpenAPI 3.1) from
|
|
16
|
+
body: `## OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry
|
|
17
17
|
|
|
18
18
|
### Purpose
|
|
19
19
|
|
|
@@ -42,9 +42,9 @@ contractspec openapi --registry ./src/registry.ts --out ./openapi.json
|
|
|
42
42
|
|
|
43
43
|
The registry module must export one of:
|
|
44
44
|
|
|
45
|
-
- \`registry:
|
|
46
|
-
- \`default():
|
|
47
|
-
- \`createRegistry():
|
|
45
|
+
- \`registry: OperationSpecRegistry\`
|
|
46
|
+
- \`default(): OperationSpecRegistry | Promise<OperationSpecRegistry>\`
|
|
47
|
+
- \`createRegistry(): OperationSpecRegistry | Promise<OperationSpecRegistry>\`
|
|
48
48
|
|
|
49
49
|
### Notes / limitations (current)
|
|
50
50
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"openapi-export.docblock.js","names":[],"sources":["../../../../../../../contracts/dist/docs/tech/contracts/openapi-export.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/contracts/openapi-export.docblock.ts\nconst tech_contracts_openapi_export_DocBlocks = [{\n\tid: \"docs.tech.contracts.openapi-export\",\n\ttitle: \"OpenAPI export (OpenAPI 3.1) from
|
|
1
|
+
{"version":3,"file":"openapi-export.docblock.js","names":[],"sources":["../../../../../../../contracts/dist/docs/tech/contracts/openapi-export.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/contracts/openapi-export.docblock.ts\nconst tech_contracts_openapi_export_DocBlocks = [{\n\tid: \"docs.tech.contracts.openapi-export\",\n\ttitle: \"OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry\",\n\tsummary: \"Generate a deterministic OpenAPI document from a OperationSpecRegistry using jsonSchemaForSpec + REST transport metadata.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/openapi-export\",\n\ttags: [\n\t\t\"contracts\",\n\t\t\"openapi\",\n\t\t\"rest\"\n\t],\n\tbody: `## OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry\n\n### Purpose\n\nContractSpec specs can be exported into an **OpenAPI 3.1** document for tooling (SDK generation, docs, gateways).\n\nThe export is **spec-first**:\n\n- Uses \\`jsonSchemaForSpec(spec)\\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)\n- Uses \\`spec.transport.rest.method/path\\` when present\n- Falls back to deterministic defaults:\n - Method: \\`POST\\` for commands, \\`GET\\` for queries\n - Path: \\`defaultRestPath(name, version)\\` → \\`/<dot/name>/v<version>\\`\n\n### Library API\n\n- Function: \\`openApiForRegistry(registry, options?)\\`\n- Location: \\`@lssm/lib.contracts/openapi\\`\n\n### CLI\n\nExport OpenAPI from a registry module:\n\n\\`\\`\\`bash\ncontractspec openapi --registry ./src/registry.ts --out ./openapi.json\n\\`\\`\\`\n\nThe registry module must export one of:\n\n- \\`registry: OperationSpecRegistry\\`\n- \\`default(): OperationSpecRegistry | Promise<OperationSpecRegistry>\\`\n- \\`createRegistry(): OperationSpecRegistry | Promise<OperationSpecRegistry>\\`\n\n### Notes / limitations (current)\n\n- Responses are generated as a basic \\`200\\` response (plus schemas when available).\n- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.\n- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`\n}];\nregisterDocBlocks(tech_contracts_openapi_export_DocBlocks);\n\n//#endregion\nexport { tech_contracts_openapi_export_DocBlocks };"],"mappings":";;;AAGA,MAAM,0CAA0C,CAAC;CAChD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCN,CAAC;AACF,kBAAkB,wCAAwC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@lssm/lib.personalization",
|
|
3
|
-
"version": "0.0.0-canary-
|
|
3
|
+
"version": "0.0.0-canary-20251221114240",
|
|
4
4
|
"description": "Behavior tracking, analysis, and adaptation helpers for ContractSpec personalization.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -24,19 +24,19 @@
|
|
|
24
24
|
"test": "bun run"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"@lssm/lib.bus": "0.0.0-canary-
|
|
28
|
-
"@lssm/lib.schema": "0.0.0-canary-
|
|
29
|
-
"@lssm/lib.contracts": "0.0.0-canary-
|
|
30
|
-
"@lssm/lib.knowledge": "0.0.0-canary-
|
|
31
|
-
"@lssm/lib.overlay-engine": "0.0.0-canary-
|
|
27
|
+
"@lssm/lib.bus": "0.0.0-canary-20251221114240",
|
|
28
|
+
"@lssm/lib.schema": "0.0.0-canary-20251221114240",
|
|
29
|
+
"@lssm/lib.contracts": "0.0.0-canary-20251221114240",
|
|
30
|
+
"@lssm/lib.knowledge": "0.0.0-canary-20251221114240",
|
|
31
|
+
"@lssm/lib.overlay-engine": "0.0.0-canary-20251221114240",
|
|
32
32
|
"@opentelemetry/api": "^1.9.0"
|
|
33
33
|
},
|
|
34
34
|
"peerDependencies": {
|
|
35
35
|
"@opentelemetry/api": "^1.9.0"
|
|
36
36
|
},
|
|
37
37
|
"devDependencies": {
|
|
38
|
-
"@lssm/tool.tsdown": "0.0.0-canary-
|
|
39
|
-
"@lssm/tool.typescript": "0.0.0-canary-
|
|
38
|
+
"@lssm/tool.tsdown": "0.0.0-canary-20251221114240",
|
|
39
|
+
"@lssm/tool.typescript": "0.0.0-canary-20251221114240",
|
|
40
40
|
"tsdown": "^0.18.1",
|
|
41
41
|
"typescript": "^5.9.3"
|
|
42
42
|
},
|