@wildo-ai/saas-technical-doc 1.1.1 → 1.1.2

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.
Files changed (64) hide show
  1. package/dist/esm/companion/application-documentation/application-administration-documentation.d.ts +52 -0
  2. package/dist/esm/companion/application-documentation/application-administration-documentation.d.ts.map +1 -0
  3. package/dist/esm/companion/application-documentation/application-administration-documentation.js +58 -0
  4. package/dist/esm/companion/application-documentation/application-administration-documentation.js.map +1 -0
  5. package/dist/esm/companion/application-documentation/application-authentication-documentation.d.ts +76 -0
  6. package/dist/esm/companion/application-documentation/application-authentication-documentation.d.ts.map +1 -0
  7. package/dist/esm/companion/application-documentation/application-authentication-documentation.js +116 -0
  8. package/dist/esm/companion/application-documentation/application-authentication-documentation.js.map +1 -0
  9. package/dist/esm/companion/application-documentation/application-connection-documentation.d.ts +87 -0
  10. package/dist/esm/companion/application-documentation/application-connection-documentation.d.ts.map +1 -0
  11. package/dist/esm/companion/application-documentation/application-connection-documentation.js +138 -0
  12. package/dist/esm/companion/application-documentation/application-connection-documentation.js.map +1 -0
  13. package/dist/esm/companion/application-documentation/application-integration-documentation.d.ts +48 -0
  14. package/dist/esm/companion/application-documentation/application-integration-documentation.d.ts.map +1 -0
  15. package/dist/esm/companion/application-documentation/application-integration-documentation.js +63 -0
  16. package/dist/esm/companion/application-documentation/application-integration-documentation.js.map +1 -0
  17. package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.d.ts +21 -3
  18. package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.d.ts.map +1 -1
  19. package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.js +166 -10
  20. package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.js.map +1 -1
  21. package/dist/esm/companion/application-documentation/technical-documentation-private-derivation.d.ts +8 -0
  22. package/dist/esm/companion/application-documentation/technical-documentation-private-derivation.d.ts.map +1 -1
  23. package/dist/esm/companion/application-documentation/technical-documentation-private-derivation.js +8 -1
  24. package/dist/esm/companion/application-documentation/technical-documentation-private-derivation.js.map +1 -1
  25. package/dist/esm/companion/index.d.ts +4 -0
  26. package/dist/esm/companion/index.d.ts.map +1 -1
  27. package/dist/esm/companion/index.js +4 -0
  28. package/dist/esm/companion/index.js.map +1 -1
  29. package/dist/esm/companion/openapi-generator.d.ts.map +1 -1
  30. package/dist/esm/companion/openapi-generator.js +9 -7
  31. package/dist/esm/companion/openapi-generator.js.map +1 -1
  32. package/dist/esm/companion/rendering/technical-documentation-docusaurus-renderer.d.ts.map +1 -1
  33. package/dist/esm/companion/rendering/technical-documentation-docusaurus-renderer.js +10 -2
  34. package/dist/esm/companion/rendering/technical-documentation-docusaurus-renderer.js.map +1 -1
  35. package/dist/esm/companion/rendering/technical-documentation-markdown-links.d.ts +28 -0
  36. package/dist/esm/companion/rendering/technical-documentation-markdown-links.d.ts.map +1 -0
  37. package/dist/esm/companion/rendering/technical-documentation-markdown-links.js +52 -0
  38. package/dist/esm/companion/rendering/technical-documentation-markdown-links.js.map +1 -0
  39. package/dist/esm/companion/rendering/technical-documentation-markdown-renderer.d.ts.map +1 -1
  40. package/dist/esm/companion/rendering/technical-documentation-markdown-renderer.js +7 -2
  41. package/dist/esm/companion/rendering/technical-documentation-markdown-renderer.js.map +1 -1
  42. package/dist/esm/companion/rendering/technical-documentation-render-model.d.ts +1 -0
  43. package/dist/esm/companion/rendering/technical-documentation-render-model.d.ts.map +1 -1
  44. package/dist/esm/companion/rendering/technical-documentation-render-model.js +91 -84
  45. package/dist/esm/companion/rendering/technical-documentation-render-model.js.map +1 -1
  46. package/dist/esm/content/application-consumer-documentation-content.techdoc.d.ts +74 -69
  47. package/dist/esm/content/application-consumer-documentation-content.techdoc.d.ts.map +1 -1
  48. package/dist/esm/content/application-consumer-documentation-content.techdoc.js +654 -1120
  49. package/dist/esm/content/application-consumer-documentation-content.techdoc.js.map +1 -1
  50. package/dist/esm/runtime/decode-jwt-claims.d.ts +7 -4
  51. package/dist/esm/runtime/decode-jwt-claims.d.ts.map +1 -1
  52. package/dist/esm/runtime/decode-jwt-claims.js +7 -4
  53. package/dist/esm/runtime/decode-jwt-claims.js.map +1 -1
  54. package/dist/esm/runtime/docs-auth-session.schemas.d.ts +16 -5
  55. package/dist/esm/runtime/docs-auth-session.schemas.d.ts.map +1 -1
  56. package/dist/esm/runtime/docs-auth-session.schemas.js +16 -5
  57. package/dist/esm/runtime/docs-auth-session.schemas.js.map +1 -1
  58. package/dist/esm/runtime/use-docs-auth-session.d.ts +9 -7
  59. package/dist/esm/runtime/use-docs-auth-session.d.ts.map +1 -1
  60. package/dist/esm/runtime/use-docs-auth-session.js +9 -7
  61. package/dist/esm/runtime/use-docs-auth-session.js.map +1 -1
  62. package/dist/tsconfig.build.tsbuildinfo +1 -1
  63. package/package.json +5 -5
  64. package/dist/esm/.builder.pid +0 -9
@@ -3,6 +3,10 @@ import type { EngineDocumentationSpecificationCatalogV1 } from '@wildo-ai/saas-s
3
3
  import type { LoadedApplicationConsumerDocumentationContentBundleV1 } from '../content/application-consumer-documentation-content-loader';
4
4
  import { type ApplicationOrganizationRolesDocumentationFact } from './technical-documentation-engine-content-bundle';
5
5
  import type { ApplicationOrganizationUnitResourcesDocumentationFact } from './application-organization-unit-resource-documentation';
6
+ import type { ApplicationConnectionDocumentationFact } from './application-connection-documentation';
7
+ import type { ApplicationAuthenticationDocumentationFact } from './application-authentication-documentation';
8
+ import type { ApplicationAdministrationDocumentationFact } from './application-administration-documentation';
9
+ import type { ApplicationIntegrationDocumentationFact } from './application-integration-documentation';
6
10
  export declare const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_REF = "technical-documentation:projector/private-derivation-v1";
7
11
  export declare const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION = 1;
8
12
  export interface CreateTechnicalDocumentationPrivateDerivationInput {
@@ -15,6 +19,10 @@ export interface CreateTechnicalDocumentationPrivateDerivationInput {
15
19
  readonly applicationOrganizationRolesFact: ApplicationOrganizationRolesDocumentationFact;
16
20
  /** Exact resources opted into organization-unit narrowing by backend startup configuration. */
17
21
  readonly applicationOrganizationUnitResourcesFact: ApplicationOrganizationUnitResourcesDocumentationFact;
22
+ readonly applicationConnectionFact: ApplicationConnectionDocumentationFact;
23
+ readonly applicationAuthenticationFact: ApplicationAuthenticationDocumentationFact;
24
+ readonly applicationAdministrationFact: ApplicationAdministrationDocumentationFact;
25
+ readonly applicationIntegrationFact: ApplicationIntegrationDocumentationFact;
18
26
  /** This derivation's own identity; the authorized bundle names it. */
19
27
  readonly derivationRef: string;
20
28
  readonly derivationVersion: number;
@@ -1 +1 @@
1
- {"version":3,"file":"technical-documentation-private-derivation.d.ts","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-private-derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iDAAiD,EACtD,KAAK,mDAAmD,EACxD,KAAK,iDAAiD,EAEvD,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,yCAAyC,CAAC;AAEzG,OAAO,KAAK,EAAE,qDAAqD,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAEL,KAAK,6CAA6C,EACnD,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,qDAAqD,EAAE,MAAM,wDAAwD,CAAC;AAEpI,eAAO,MAAM,wDAAwD,4DAA4D,CAAC;AAClI,eAAO,MAAM,4DAA4D,IAAI,CAAC;AAE9E,MAAM,WAAW,kDAAkD;IACjE,QAAQ,CAAC,mBAAmB,EAAE,qDAAqD,CAAC;IACpF,QAAQ,CAAC,2BAA2B,EAAE,mDAAmD,CAAC;IAC1F,wEAAwE;IACxE,QAAQ,CAAC,0BAA0B,EAAE,yCAAyC,CAAC;IAC/E,QAAQ,CAAC,kCAAkC,EAAE,iDAAiD,CAAC;IAC/F,0FAA0F;IAC1F,QAAQ,CAAC,gCAAgC,EAAE,6CAA6C,CAAC;IACzF,+FAA+F;IAC/F,QAAQ,CAAC,wCAAwC,EAAE,qDAAqD,CAAC;IACzG,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,kDAAkD,GACxD,iDAAiD,CA0BnD"}
1
+ {"version":3,"file":"technical-documentation-private-derivation.d.ts","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-private-derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iDAAiD,EACtD,KAAK,mDAAmD,EACxD,KAAK,iDAAiD,EAEvD,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,yCAAyC,CAAC;AAEzG,OAAO,KAAK,EAAE,qDAAqD,EAAE,MAAM,8DAA8D,CAAC;AAC1I,OAAO,EAEL,KAAK,6CAA6C,EACnD,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,qDAAqD,EAAE,MAAM,wDAAwD,CAAC;AACpI,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,wCAAwC,CAAC;AACrG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,4CAA4C,CAAC;AAC7G,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,4CAA4C,CAAC;AAC7G,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,yCAAyC,CAAC;AAEvG,eAAO,MAAM,wDAAwD,4DAA4D,CAAC;AAClI,eAAO,MAAM,4DAA4D,IAAI,CAAC;AAE9E,MAAM,WAAW,kDAAkD;IACjE,QAAQ,CAAC,mBAAmB,EAAE,qDAAqD,CAAC;IACpF,QAAQ,CAAC,2BAA2B,EAAE,mDAAmD,CAAC;IAC1F,wEAAwE;IACxE,QAAQ,CAAC,0BAA0B,EAAE,yCAAyC,CAAC;IAC/E,QAAQ,CAAC,kCAAkC,EAAE,iDAAiD,CAAC;IAC/F,0FAA0F;IAC1F,QAAQ,CAAC,gCAAgC,EAAE,6CAA6C,CAAC;IACzF,+FAA+F;IAC/F,QAAQ,CAAC,wCAAwC,EAAE,qDAAqD,CAAC;IACzG,QAAQ,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;IAC3E,QAAQ,CAAC,6BAA6B,EAAE,0CAA0C,CAAC;IACnF,QAAQ,CAAC,6BAA6B,EAAE,0CAA0C,CAAC;IACnF,QAAQ,CAAC,0BAA0B,EAAE,uCAAuC,CAAC;IAC7E,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,6CAA6C,CAC3D,KAAK,EAAE,kDAAkD,GACxD,iDAAiD,CAgCnD"}
@@ -10,7 +10,14 @@ export const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION = 1;
10
10
  * owns an accepted authoring artifact for that later join.
11
11
  */
12
12
  export function createTechnicalDocumentationPrivateDerivation(input) {
13
- const engineUnits = projectEngineApplicationConsumerContentBundle(input.engineContentBundle, input.engineSpecificationCatalog, undefined, input.applicationOrganizationRolesFact, input.applicationOrganizationUnitResourcesFact);
13
+ const engineUnits = projectEngineApplicationConsumerContentBundle(input.engineContentBundle, input.engineSpecificationCatalog, undefined, {
14
+ organizationRoles: input.applicationOrganizationRolesFact,
15
+ organizationUnitResources: input.applicationOrganizationUnitResourcesFact,
16
+ connection: input.applicationConnectionFact,
17
+ authentication: input.applicationAuthenticationFact,
18
+ administration: input.applicationAdministrationFact,
19
+ integration: input.applicationIntegrationFact,
20
+ });
14
21
  const unitsByRef = new Map();
15
22
  for (const unit of engineUnits) {
16
23
  if (unitsByRef.has(unit.unitRef))
@@ -1 +1 @@
1
- {"version":3,"file":"technical-documentation-private-derivation.js","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-private-derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uDAAuD,GAKxD,MAAM,uDAAuD,CAAC;AAI/D,OAAO,EACL,6CAA6C,GAE9C,MAAM,iDAAiD,CAAC;AAGzD,MAAM,CAAC,MAAM,wDAAwD,GAAG,yDAAyD,CAAC;AAClI,MAAM,CAAC,MAAM,4DAA4D,GAAG,CAAC,CAAC;AAkB9E;;;;;;GAMG;AACH,MAAM,UAAU,6CAA6C,CAC3D,KAAyD;IAEzD,MAAM,WAAW,GAAG,6CAA6C,CAC/D,KAAK,CAAC,mBAAmB,EACzB,KAAK,CAAC,0BAA0B,EAChC,SAAS,EACT,KAAK,CAAC,gCAAgC,EACtC,KAAK,CAAC,wCAAwC,CAC/C,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwC,CAAC;IACnE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvH,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,uDAAuD,CAAC;QAC7D,aAAa,EAAE,CAAC;QAChB,2BAA2B,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ;QAC/D,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;QAC9D,kCAAkC,EAAE,KAAK,CAAC,kCAAkC;QAC5E,YAAY,EAAE,wDAAwD;QACtE,gBAAgB,EAAE,4DAA4D;QAC9E,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n createTechnicalDocumentationPrivateDerivationManifestV1,\n type EngineDocumentationSpecificationCatalogIdentityV1,\n type TechnicalDocumentationEnvironmentEvidenceSnapshotV1,\n type TechnicalDocumentationPrivateDerivationManifestV1,\n type TechnicalDocumentationUnitV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\nimport type { EngineDocumentationSpecificationCatalogV1 } from '@wildo-ai/saas-specifications/companion';\n\nimport type { LoadedApplicationConsumerDocumentationContentBundleV1 } from '../content/application-consumer-documentation-content-loader';\nimport {\n projectEngineApplicationConsumerContentBundle,\n type ApplicationOrganizationRolesDocumentationFact,\n} from './technical-documentation-engine-content-bundle';\nimport type { ApplicationOrganizationUnitResourcesDocumentationFact } from './application-organization-unit-resource-documentation';\n\nexport const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_REF = 'technical-documentation:projector/private-derivation-v1';\nexport const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION = 1;\n\nexport interface CreateTechnicalDocumentationPrivateDerivationInput {\n readonly engineContentBundle: LoadedApplicationConsumerDocumentationContentBundleV1;\n readonly environmentEvidenceSnapshot: TechnicalDocumentationEnvironmentEvidenceSnapshotV1;\n /** Exact safe fact catalog used to compose the engine-content units. */\n readonly engineSpecificationCatalog: EngineDocumentationSpecificationCatalogV1;\n readonly engineSpecificationCatalogIdentity: EngineDocumentationSpecificationCatalogIdentityV1;\n /** Resolved organization roles and their application-authored semantic specifications. */\n readonly applicationOrganizationRolesFact: ApplicationOrganizationRolesDocumentationFact;\n /** Exact resources opted into organization-unit narrowing by backend startup configuration. */\n readonly applicationOrganizationUnitResourcesFact: ApplicationOrganizationUnitResourcesDocumentationFact;\n /** This derivation's own identity; the authorized bundle names it. */\n readonly derivationRef: string;\n readonly derivationVersion: number;\n readonly derivedAt: string;\n}\n\n/**\n * Joins exact framework and environment identities into the private semantic artifact.\n *\n * This reusable function performs no application-design discovery and chooses\n * no output path. Application content remains absent until the app-creator\n * owns an accepted authoring artifact for that later join.\n */\nexport function createTechnicalDocumentationPrivateDerivation(\n input: CreateTechnicalDocumentationPrivateDerivationInput,\n): TechnicalDocumentationPrivateDerivationManifestV1 {\n const engineUnits = projectEngineApplicationConsumerContentBundle(\n input.engineContentBundle,\n input.engineSpecificationCatalog,\n undefined,\n input.applicationOrganizationRolesFact,\n input.applicationOrganizationUnitResourcesFact,\n );\n const unitsByRef = new Map<string, TechnicalDocumentationUnitV1>();\n for (const unit of engineUnits) {\n if (unitsByRef.has(unit.unitRef)) throw new Error(`duplicate engine technical-documentation unitRef: ${unit.unitRef}`);\n unitsByRef.set(unit.unitRef, unit);\n }\n\n return createTechnicalDocumentationPrivateDerivationManifestV1({\n schemaVersion: 1,\n engineContentBundleIdentity: input.engineContentBundle.identity,\n environmentEvidenceSnapshot: input.environmentEvidenceSnapshot,\n engineSpecificationCatalogIdentity: input.engineSpecificationCatalogIdentity,\n projectorRef: TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_REF,\n projectorVersion: TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION,\n derivationRef: input.derivationRef,\n derivationVersion: input.derivationVersion,\n units: [...unitsByRef.values()],\n derivedAt: input.derivedAt,\n });\n}\n"]}
1
+ {"version":3,"file":"technical-documentation-private-derivation.js","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-private-derivation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uDAAuD,GAKxD,MAAM,uDAAuD,CAAC;AAI/D,OAAO,EACL,6CAA6C,GAE9C,MAAM,iDAAiD,CAAC;AAOzD,MAAM,CAAC,MAAM,wDAAwD,GAAG,yDAAyD,CAAC;AAClI,MAAM,CAAC,MAAM,4DAA4D,GAAG,CAAC,CAAC;AAsB9E;;;;;;GAMG;AACH,MAAM,UAAU,6CAA6C,CAC3D,KAAyD;IAEzD,MAAM,WAAW,GAAG,6CAA6C,CAC/D,KAAK,CAAC,mBAAmB,EACzB,KAAK,CAAC,0BAA0B,EAChC,SAAS,EACT;QACE,iBAAiB,EAAE,KAAK,CAAC,gCAAgC;QACzD,yBAAyB,EAAE,KAAK,CAAC,wCAAwC;QACzE,UAAU,EAAE,KAAK,CAAC,yBAAyB;QAC3C,cAAc,EAAE,KAAK,CAAC,6BAA6B;QACnD,cAAc,EAAE,KAAK,CAAC,6BAA6B;QACnD,WAAW,EAAE,KAAK,CAAC,0BAA0B;KAC9C,CACF,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAwC,CAAC;IACnE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvH,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,uDAAuD,CAAC;QAC7D,aAAa,EAAE,CAAC;QAChB,2BAA2B,EAAE,KAAK,CAAC,mBAAmB,CAAC,QAAQ;QAC/D,2BAA2B,EAAE,KAAK,CAAC,2BAA2B;QAC9D,kCAAkC,EAAE,KAAK,CAAC,kCAAkC;QAC5E,YAAY,EAAE,wDAAwD;QACtE,gBAAgB,EAAE,4DAA4D;QAC9E,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,KAAK,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;QAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n createTechnicalDocumentationPrivateDerivationManifestV1,\n type EngineDocumentationSpecificationCatalogIdentityV1,\n type TechnicalDocumentationEnvironmentEvidenceSnapshotV1,\n type TechnicalDocumentationPrivateDerivationManifestV1,\n type TechnicalDocumentationUnitV1,\n} from '@wildo-ai/saas-specifications/technical-documentation';\nimport type { EngineDocumentationSpecificationCatalogV1 } from '@wildo-ai/saas-specifications/companion';\n\nimport type { LoadedApplicationConsumerDocumentationContentBundleV1 } from '../content/application-consumer-documentation-content-loader';\nimport {\n projectEngineApplicationConsumerContentBundle,\n type ApplicationOrganizationRolesDocumentationFact,\n} from './technical-documentation-engine-content-bundle';\nimport type { ApplicationOrganizationUnitResourcesDocumentationFact } from './application-organization-unit-resource-documentation';\nimport type { ApplicationConnectionDocumentationFact } from './application-connection-documentation';\nimport type { ApplicationAuthenticationDocumentationFact } from './application-authentication-documentation';\nimport type { ApplicationAdministrationDocumentationFact } from './application-administration-documentation';\nimport type { ApplicationIntegrationDocumentationFact } from './application-integration-documentation';\n\nexport const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_REF = 'technical-documentation:projector/private-derivation-v1';\nexport const TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION = 1;\n\nexport interface CreateTechnicalDocumentationPrivateDerivationInput {\n readonly engineContentBundle: LoadedApplicationConsumerDocumentationContentBundleV1;\n readonly environmentEvidenceSnapshot: TechnicalDocumentationEnvironmentEvidenceSnapshotV1;\n /** Exact safe fact catalog used to compose the engine-content units. */\n readonly engineSpecificationCatalog: EngineDocumentationSpecificationCatalogV1;\n readonly engineSpecificationCatalogIdentity: EngineDocumentationSpecificationCatalogIdentityV1;\n /** Resolved organization roles and their application-authored semantic specifications. */\n readonly applicationOrganizationRolesFact: ApplicationOrganizationRolesDocumentationFact;\n /** Exact resources opted into organization-unit narrowing by backend startup configuration. */\n readonly applicationOrganizationUnitResourcesFact: ApplicationOrganizationUnitResourcesDocumentationFact;\n readonly applicationConnectionFact: ApplicationConnectionDocumentationFact;\n readonly applicationAuthenticationFact: ApplicationAuthenticationDocumentationFact;\n readonly applicationAdministrationFact: ApplicationAdministrationDocumentationFact;\n readonly applicationIntegrationFact: ApplicationIntegrationDocumentationFact;\n /** This derivation's own identity; the authorized bundle names it. */\n readonly derivationRef: string;\n readonly derivationVersion: number;\n readonly derivedAt: string;\n}\n\n/**\n * Joins exact framework and environment identities into the private semantic artifact.\n *\n * This reusable function performs no application-design discovery and chooses\n * no output path. Application content remains absent until the app-creator\n * owns an accepted authoring artifact for that later join.\n */\nexport function createTechnicalDocumentationPrivateDerivation(\n input: CreateTechnicalDocumentationPrivateDerivationInput,\n): TechnicalDocumentationPrivateDerivationManifestV1 {\n const engineUnits = projectEngineApplicationConsumerContentBundle(\n input.engineContentBundle,\n input.engineSpecificationCatalog,\n undefined,\n {\n organizationRoles: input.applicationOrganizationRolesFact,\n organizationUnitResources: input.applicationOrganizationUnitResourcesFact,\n connection: input.applicationConnectionFact,\n authentication: input.applicationAuthenticationFact,\n administration: input.applicationAdministrationFact,\n integration: input.applicationIntegrationFact,\n },\n );\n const unitsByRef = new Map<string, TechnicalDocumentationUnitV1>();\n for (const unit of engineUnits) {\n if (unitsByRef.has(unit.unitRef)) throw new Error(`duplicate engine technical-documentation unitRef: ${unit.unitRef}`);\n unitsByRef.set(unit.unitRef, unit);\n }\n\n return createTechnicalDocumentationPrivateDerivationManifestV1({\n schemaVersion: 1,\n engineContentBundleIdentity: input.engineContentBundle.identity,\n environmentEvidenceSnapshot: input.environmentEvidenceSnapshot,\n engineSpecificationCatalogIdentity: input.engineSpecificationCatalogIdentity,\n projectorRef: TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_REF,\n projectorVersion: TECHNICAL_DOCUMENTATION_PRIVATE_DERIVATION_PROJECTOR_VERSION,\n derivationRef: input.derivationRef,\n derivationVersion: input.derivationVersion,\n units: [...unitsByRef.values()],\n derivedAt: input.derivedAt,\n });\n}\n"]}
@@ -31,6 +31,10 @@ export * from './rendering/technical-documentation-openapi-renderer';
31
31
  export * from './rendering/technical-documentation-render-model';
32
32
  export * from './rendering/technical-documentation-search-index-renderer';
33
33
  export * from './application-documentation/technical-documentation-engine-content-bundle';
34
+ export * from './application-documentation/application-integration-documentation';
35
+ export * from './application-documentation/application-administration-documentation';
36
+ export * from './application-documentation/application-authentication-documentation';
37
+ export * from './application-documentation/application-connection-documentation';
34
38
  export * from './application-documentation/application-organization-role-documentation';
35
39
  export * from './application-documentation/application-organization-unit-resource-documentation';
36
40
  export * from './application-documentation/technical-documentation-operational-evidence';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6DAA6D,CAAC;AAC5E,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,uDAAuD,CAAC;AACtE,cAAc,sDAAsD,CAAC;AACrE,cAAc,kDAAkD,CAAC;AACjE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2EAA2E,CAAC;AAC1F,cAAc,yEAAyE,CAAC;AACxF,cAAc,kFAAkF,CAAC;AACjG,cAAc,0EAA0E,CAAC;AACzF,cAAc,wEAAwE,CAAC;AACvF,cAAc,wEAAwE,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6DAA6D,CAAC;AAC5E,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,uDAAuD,CAAC;AACtE,cAAc,sDAAsD,CAAC;AACrE,cAAc,kDAAkD,CAAC;AACjE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2EAA2E,CAAC;AAC1F,cAAc,mEAAmE,CAAC;AAClF,cAAc,sEAAsE,CAAC;AACrF,cAAc,sEAAsE,CAAC;AACrF,cAAc,kEAAkE,CAAC;AACjF,cAAc,yEAAyE,CAAC;AACxF,cAAc,kFAAkF,CAAC;AACjG,cAAc,0EAA0E,CAAC;AACzF,cAAc,wEAAwE,CAAC;AACvF,cAAc,wEAAwE,CAAC"}
@@ -31,6 +31,10 @@ export * from './rendering/technical-documentation-openapi-renderer.js';
31
31
  export * from './rendering/technical-documentation-render-model.js';
32
32
  export * from './rendering/technical-documentation-search-index-renderer.js';
33
33
  export * from './application-documentation/technical-documentation-engine-content-bundle.js';
34
+ export * from './application-documentation/application-integration-documentation.js';
35
+ export * from './application-documentation/application-administration-documentation.js';
36
+ export * from './application-documentation/application-authentication-documentation.js';
37
+ export * from './application-documentation/application-connection-documentation.js';
34
38
  export * from './application-documentation/application-organization-role-documentation.js';
35
39
  export * from './application-documentation/application-organization-unit-resource-documentation.js';
36
40
  export * from './application-documentation/technical-documentation-operational-evidence.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6DAA6D,CAAC;AAC5E,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,uDAAuD,CAAC;AACtE,cAAc,sDAAsD,CAAC;AACrE,cAAc,kDAAkD,CAAC;AACjE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2EAA2E,CAAC;AAC1F,cAAc,yEAAyE,CAAC;AACxF,cAAc,kFAAkF,CAAC;AACjG,cAAc,0EAA0E,CAAC;AACzF,cAAc,wEAAwE,CAAC;AACvF,cAAc,wEAAwE,CAAC","sourcesContent":["/**\n * `@wildo-ai/saas-technical-doc/companion` — implementation surface.\n *\n * Pure-function OpenAPI projection, its input contract, and Node-side verification/materialization utilities for an exact engine-owned\n * application-consumer documentation content bundle. Consumed by:\n * - `examples/<app>/.wildo-saas/wildo-dev-companion/` controllers\n * that call `generateOpenApiDocuments(input)` to produce\n * the normal and application-administration YAML/JSON OpenAPI documents.\n *\n * @wildo-boundary\n * Re-exports only companion-side OpenAPI and application-consumer content projection surfaces. All are React-free; the content loader is Node-only and\n * never enters the browser runtime closure. Reusable authored content and portable identities are owned by the separate `./content`\n * entry point.\n */\n\nexport * from './operation-projection.schemas';\nexport * from './openapi-generator';\nexport * from './publish-result.types';\nexport * from './zod-to-openapi';\nexport * from './spec-to-operation-doc';\nexport * from './content/application-consumer-documentation-content-loader';\nexport * from './technical-documentation-capture-execution-port';\nexport * from './technical-documentation-asset-path';\nexport * from './technical-documentation-diagram-materializer';\nexport * from './technical-documentation-placeholder-materializer';\nexport * from './rendering/technical-documentation-authorized-bundle-reader';\nexport * from './rendering/technical-documentation-docusaurus-renderer';\nexport * from './rendering/technical-documentation-build-measurement';\nexport * from './rendering/technical-documentation-managed-tree-validator';\nexport * from './rendering/technical-documentation-markdown-renderer';\nexport * from './rendering/technical-documentation-openapi-renderer';\nexport * from './rendering/technical-documentation-render-model';\nexport * from './rendering/technical-documentation-search-index-renderer';\nexport * from './application-documentation/technical-documentation-engine-content-bundle';\nexport * from './application-documentation/application-organization-role-documentation';\nexport * from './application-documentation/application-organization-unit-resource-documentation';\nexport * from './application-documentation/technical-documentation-operational-evidence';\nexport * from './application-documentation/technical-documentation-private-derivation';\nexport * from './application-documentation/technical-documentation-publication-policy';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6DAA6D,CAAC;AAC5E,cAAc,kDAAkD,CAAC;AACjE,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,yDAAyD,CAAC;AACxE,cAAc,uDAAuD,CAAC;AACtE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,uDAAuD,CAAC;AACtE,cAAc,sDAAsD,CAAC;AACrE,cAAc,kDAAkD,CAAC;AACjE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2EAA2E,CAAC;AAC1F,cAAc,mEAAmE,CAAC;AAClF,cAAc,sEAAsE,CAAC;AACrF,cAAc,sEAAsE,CAAC;AACrF,cAAc,kEAAkE,CAAC;AACjF,cAAc,yEAAyE,CAAC;AACxF,cAAc,kFAAkF,CAAC;AACjG,cAAc,0EAA0E,CAAC;AACzF,cAAc,wEAAwE,CAAC;AACvF,cAAc,wEAAwE,CAAC","sourcesContent":["/**\n * `@wildo-ai/saas-technical-doc/companion` — implementation surface.\n *\n * Pure-function OpenAPI projection, its input contract, and Node-side verification/materialization utilities for an exact engine-owned\n * application-consumer documentation content bundle. Consumed by:\n * - `examples/<app>/.wildo-saas/wildo-dev-companion/` controllers\n * that call `generateOpenApiDocuments(input)` to produce\n * the normal and application-administration YAML/JSON OpenAPI documents.\n *\n * @wildo-boundary\n * Re-exports only companion-side OpenAPI and application-consumer content projection surfaces. All are React-free; the content loader is Node-only and\n * never enters the browser runtime closure. Reusable authored content and portable identities are owned by the separate `./content`\n * entry point.\n */\n\nexport * from './operation-projection.schemas';\nexport * from './openapi-generator';\nexport * from './publish-result.types';\nexport * from './zod-to-openapi';\nexport * from './spec-to-operation-doc';\nexport * from './content/application-consumer-documentation-content-loader';\nexport * from './technical-documentation-capture-execution-port';\nexport * from './technical-documentation-asset-path';\nexport * from './technical-documentation-diagram-materializer';\nexport * from './technical-documentation-placeholder-materializer';\nexport * from './rendering/technical-documentation-authorized-bundle-reader';\nexport * from './rendering/technical-documentation-docusaurus-renderer';\nexport * from './rendering/technical-documentation-build-measurement';\nexport * from './rendering/technical-documentation-managed-tree-validator';\nexport * from './rendering/technical-documentation-markdown-renderer';\nexport * from './rendering/technical-documentation-openapi-renderer';\nexport * from './rendering/technical-documentation-render-model';\nexport * from './rendering/technical-documentation-search-index-renderer';\nexport * from './application-documentation/technical-documentation-engine-content-bundle';\nexport * from './application-documentation/application-integration-documentation';\nexport * from './application-documentation/application-administration-documentation';\nexport * from './application-documentation/application-authentication-documentation';\nexport * from './application-documentation/application-connection-documentation';\nexport * from './application-documentation/application-organization-role-documentation';\nexport * from './application-documentation/application-organization-unit-resource-documentation';\nexport * from './application-documentation/technical-documentation-operational-evidence';\nexport * from './application-documentation/technical-documentation-private-derivation';\nexport * from './application-documentation/technical-documentation-publication-policy';\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"openapi-generator.d.ts","sourceRoot":"","sources":["../../../../src/companion/openapi-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAIH,OAAO,EACL,cAAc,EACd,KAAK,uBAAuB,EAE7B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC7C,aAAa,CAAC,mBAAmB,CAAC,CAUpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC7C,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAqBtE;AAihDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,uBAAuB,CAyBnF"}
1
+ {"version":3,"file":"openapi-generator.d.ts","sourceRoot":"","sources":["../../../../src/companion/openapi-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAKH,OAAO,EACL,cAAc,EACd,KAAK,uBAAuB,EAE7B,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC7C,aAAa,CAAC,mBAAmB,CAAC,CAUpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,GAC7C,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAqBtE;AAkhDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,uBAAuB,CAyBnF"}
@@ -41,6 +41,7 @@
41
41
  * barrel enters this semantic generator.
42
42
  */
43
43
  import { WildoHeaderKeys } from '@wildo-ai/saas-models/public-runtime';
44
+ import { COLLECTION_QUERY_PARAMETERS, Resources_PaginationRequestSchema } from '@wildo-ai/saas-models';
44
45
  import { OpenApiSection, } from '../openapi/openapi-generation-output.schemas.js';
45
46
  import { OpenApiGenerationInputSchema, OPENAPI_RESOURCE_IDENTITY_CONTRACT_VERSION, OperationProjectionAuthenticationMode, OperationProjectionVariantType, } from './operation-projection.schemas.js';
46
47
  import { stripImplementationNoise } from './spec-to-operation-doc.js';
@@ -403,7 +404,7 @@ function buildQueryParametersFromRequestSchema(op) {
403
404
  // operation. The flat trio names are excluded too so a DTO can never collide with
404
405
  // them. Ops WITHOUT the pagination contract keep every DTO property untouched.
405
406
  const paginationAxisProperties = op.pagination !== undefined
406
- ? new Set(['pagination', 'sorting', 'filters', 'page', 'limit', 'sort'])
407
+ ? new Set(['pagination', 'sorting', 'filters', COLLECTION_QUERY_PARAMETERS.page, COLLECTION_QUERY_PARAMETERS.limit, COLLECTION_QUERY_PARAMETERS.sort])
407
408
  : new Set();
408
409
  return Object.entries(properties)
409
410
  .filter(([name]) => !paginationAxisProperties.has(name))
@@ -522,7 +523,7 @@ function buildCollectionFilterQueryParameters(op) {
522
523
  // nested fallback name, so it is surfaced under the wire name, not verbatim.
523
524
  if ('searchRequest' in filterProperties) {
524
525
  parameters.push(attachParameterExamples(op, {
525
- name: 'q',
526
+ name: COLLECTION_QUERY_PARAMETERS.search,
526
527
  in: 'query',
527
528
  required: false,
528
529
  schema: { type: 'string' },
@@ -574,8 +575,9 @@ function buildCollectionFilterQueryParameters(op) {
574
575
  * must not import `@wildo-ai/saas-backend-lib`); keep in sync with the
575
576
  * repository defaults.
576
577
  */
577
- const PAGINATION_DEFAULT_PAGE = 1;
578
- const PAGINATION_DEFAULT_LIMIT = 20;
578
+ // Defaults are read off the shared pagination request schema, never restated.
579
+ const PAGINATION_DEFAULT_PAGE = Resources_PaginationRequestSchema.shape.page.parse(undefined);
580
+ const PAGINATION_DEFAULT_LIMIT = Resources_PaginationRequestSchema.shape.limit.parse(undefined);
579
581
  /**
580
582
  * Emits the flat `page` / `limit` / `sort` query parameters for a paginated
581
583
  * collection operation (`op.pagination` present — LIST / SEARCH-like; see the
@@ -613,21 +615,21 @@ function buildPaginationQueryParameters(op) {
613
615
  + '(e.g. `createdAt:desc`). Defaults to `createdAt:desc` (newest first).';
614
616
  return [
615
617
  {
616
- name: 'page',
618
+ name: COLLECTION_QUERY_PARAMETERS.page,
617
619
  in: 'query',
618
620
  required: false,
619
621
  schema: { type: 'integer', minimum: 1, default: PAGINATION_DEFAULT_PAGE },
620
622
  description: '1-based page number of the collection slice.',
621
623
  },
622
624
  {
623
- name: 'limit',
625
+ name: COLLECTION_QUERY_PARAMETERS.limit,
624
626
  in: 'query',
625
627
  required: false,
626
628
  schema: { type: 'integer', minimum: 1, maximum: pagination.maxLimit, default: PAGINATION_DEFAULT_LIMIT },
627
629
  description: `Maximum number of items per page (up to ${pagination.maxLimit}).`,
628
630
  },
629
631
  {
630
- name: 'sort',
632
+ name: COLLECTION_QUERY_PARAMETERS.sort,
631
633
  in: 'query',
632
634
  required: false,
633
635
  schema: { type: 'string' },