@wildo-ai/saas-specifications 1.1.5 → 1.1.6
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/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts +10 -8
- package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js +14 -13
- package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts +3 -2
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js +4 -3
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js.map +1 -1
- package/dist/esm/_catalogs/schema-org/index.d.ts +31 -15
- package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/index.js +34 -13
- package/dist/esm/_catalogs/schema-org/index.js.map +1 -1
- package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts +2 -2
- package/dist/esm/_catalogs/schema-org/product.catalog-spec.js +4 -4
- package/dist/esm/_catalogs/schema-org/product.catalog-spec.js.map +1 -1
- package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts +45 -0
- package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts.map +1 -0
- package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js +58 -0
- package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js.map +1 -0
- package/dist/esm/_core/application-specification-family-identity.schemas.d.ts +3 -2
- package/dist/esm/_core/application-specification-family-identity.schemas.d.ts.map +1 -1
- package/dist/esm/_core/application-specification-family-identity.schemas.js +3 -2
- package/dist/esm/_core/application-specification-family-identity.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts +18 -0
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +39 -13
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +43 -13
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts +90 -2
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js +70 -6
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan.family-aspects.js +26 -4
- package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -1
- package/dist/esm/_core/business-semantics.specifications.schemas.d.ts +14 -0
- package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-semantics.specifications.schemas.js.map +1 -1
- package/dist/esm/_core/capability-composition/capability-composition-validation.d.ts.map +1 -1
- package/dist/esm/_core/capability-composition/capability-composition-validation.js +1 -0
- package/dist/esm/_core/capability-composition/capability-composition-validation.js.map +1 -1
- package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts +21 -2
- package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts.map +1 -1
- package/dist/esm/_core/capability-composition/capability-composition.schemas.js +20 -1
- package/dist/esm/_core/capability-composition/capability-composition.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +11 -32
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +70 -3
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts +142 -17
- package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js +285 -30
- package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +183 -18
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js +165 -18
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts +139 -0
- package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js +172 -0
- package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js.map +1 -0
- package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts +306 -0
- package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/recipient-population.schemas.js +502 -0
- package/dist/esm/_core/compliance-documents/recipient-population.schemas.js.map +1 -0
- package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts +107 -0
- package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js +118 -0
- package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js.map +1 -0
- package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts +56 -0
- package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js +100 -0
- package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js.map +1 -0
- package/dist/esm/_core/composite-view-specification.schemas.js +8 -1
- package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -2
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +3 -2
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -1
- package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts +16 -3
- package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/experience-plan/experience-plan.schemas.js +70 -5
- package/dist/esm/_core/experience-plan/experience-plan.schemas.js.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.d.ts +10 -0
- package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +2 -2
- package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts +1 -0
- package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts +16 -0
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js +8 -0
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js.map +1 -1
- package/dist/esm/_core/index.d.ts +3 -0
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js +3 -0
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts +5 -0
- package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js +3 -1
- package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js +12 -2
- package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts +30 -2
- package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/integration-plan/integration-plan.schemas.js +32 -2
- package/dist/esm/_core/integration-plan/integration-plan.schemas.js.map +1 -1
- package/dist/esm/_core/market/feature-benefit.schemas.js +2 -2
- package/dist/esm/_core/market/feature-benefit.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-alternative.schemas.js +2 -2
- package/dist/esm/_core/market/market-alternative.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-buying-journey.schemas.js +2 -2
- package/dist/esm/_core/market/market-buying-journey.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-category.schemas.js +2 -2
- package/dist/esm/_core/market/market-category.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-channel.schemas.js +2 -2
- package/dist/esm/_core/market/market-channel.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-gain.schemas.js +2 -2
- package/dist/esm/_core/market/market-gain.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-icp.schemas.js +2 -2
- package/dist/esm/_core/market/market-icp.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-job.schemas.js +2 -2
- package/dist/esm/_core/market/market-job.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-message-template.schemas.js +2 -2
- package/dist/esm/_core/market/market-message-template.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-objection.schemas.js +2 -2
- package/dist/esm/_core/market/market-objection.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-pain.schemas.js +2 -2
- package/dist/esm/_core/market/market-pain.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-persona.schemas.js +2 -2
- package/dist/esm/_core/market/market-persona.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-positioning.schemas.js +2 -2
- package/dist/esm/_core/market/market-positioning.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-proof.schemas.js +2 -2
- package/dist/esm/_core/market/market-proof.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-references.schemas.d.ts +6 -0
- package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-references.schemas.js +6 -0
- package/dist/esm/_core/market/market-references.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +4 -4
- package/dist/esm/_core/market/market-tone-of-voice.schemas.js +2 -2
- package/dist/esm/_core/market/market-tone-of-voice.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-trigger.schemas.js +2 -2
- package/dist/esm/_core/market/market-trigger.schemas.js.map +1 -1
- package/dist/esm/_core/market/market.family-aspects.js +1 -1
- package/dist/esm/_core/market/market.family-aspects.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js +6 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
- package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts +1 -0
- package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/functional-requirement.schemas.js +8 -0
- package/dist/esm/_core/requirements/functional-requirement.schemas.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts +1 -0
- package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification.schemas.d.ts +86 -28
- package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification.schemas.js +110 -24
- package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
- package/dist/esm/_core/utils/retention-clock-field-specs.d.ts +13 -0
- package/dist/esm/_core/utils/retention-clock-field-specs.d.ts.map +1 -0
- package/dist/esm/_core/utils/retention-clock-field-specs.js +26 -0
- package/dist/esm/_core/utils/retention-clock-field-specs.js.map +1 -0
- package/dist/esm/_core/website-plan/website-plan.schemas.d.ts +31 -6
- package/dist/esm/_core/website-plan/website-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/website-plan/website-plan.schemas.js +35 -6
- package/dist/esm/_core/website-plan/website-plan.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts +142 -3
- package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js +148 -14
- package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +70 -10
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +98 -11
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts +215 -0
- package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts.map +1 -0
- package/dist/esm/application-creation/application-line.application-creation.schemas.js +253 -0
- package/dist/esm/application-creation/application-line.application-creation.schemas.js.map +1 -0
- package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts +39 -0
- package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts.map +1 -0
- package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js +37 -0
- package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js.map +1 -0
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +5 -49
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.js +25 -60
- package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts +28 -0
- package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts.map +1 -0
- package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js +32 -0
- package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js.map +1 -0
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +26 -6
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +28 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation.exports.d.ts +7 -0
- package/dist/esm/application-creation.exports.d.ts.map +1 -1
- package/dist/esm/application-creation.exports.js +7 -0
- package/dist/esm/application-creation.exports.js.map +1 -1
- package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.d.ts +1 -1
- package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js +1 -1
- package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +24 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +75 -5
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +6 -0
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +11 -0
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.js +22 -3
- package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.js +39 -6
- package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts +11 -0
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.js +19 -0
- package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +295 -31
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts +7 -0
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.js +7 -0
- package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +17 -0
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +5 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.js +6 -3
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-program.family-aspects.js +1 -1
- package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.d.ts +232 -3
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +107 -14
- package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.js +77 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +23 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
- package/dist/esm/assurance/governed-document-release.d.ts +7 -0
- package/dist/esm/assurance/governed-document-release.d.ts.map +1 -1
- package/dist/esm/assurance/governed-document-release.js +11 -2
- package/dist/esm/assurance/governed-document-release.js.map +1 -1
- package/dist/esm/companion-exports.d.ts +6 -5
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts +1 -0
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +35 -33
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +6 -2
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +13 -12
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +26 -2
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js +4 -4
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +11 -9
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts +1 -0
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +45 -32
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +1 -23
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +185 -31
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +2 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +29 -7
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +7 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +9 -6
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts +1 -0
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +11 -7
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +18 -16
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +9 -11
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +238 -219
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +0 -24
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +76 -16
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +2 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +28 -6
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +29 -11
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js +1 -1
- package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +2 -0
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +13 -12
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +5 -5
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.js +12 -9
- package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.d.ts +7 -4
- package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.js +36 -16
- package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js +13 -10
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts +13 -8
- package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js +54 -20
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +30 -4
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +85 -25
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +2 -2
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +15 -2
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +45 -10
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts +15 -2
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +52 -12
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
- package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/index.js +1 -0
- package/dist/esm/engine/compliance/resources/index.js.map +1 -1
- package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts +39 -0
- package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js +325 -0
- package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js.map +1 -0
- package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts +23 -0
- package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js +197 -0
- package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js.map +1 -0
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.js +59 -0
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +69 -0
- package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts +5 -5
- package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.js +9 -10
- package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts +5 -5
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js +11 -11
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts +5 -5
- package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js +7 -8
- package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +16 -4
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts +11 -0
- package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js +382 -0
- package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js.map +1 -0
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +139 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +150 -4
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +9 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts +3 -0
- package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js +162 -0
- package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js.map +1 -0
- package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts +3 -0
- package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js +158 -0
- package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js.map +1 -0
- package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts +2 -1
- package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js +16 -9
- package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts +5 -0
- package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts.map +1 -0
- package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js +79 -0
- package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js.map +1 -0
- package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js +3 -1
- package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +5 -4
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js +2 -2
- package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js +2 -2
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js +2 -2
- package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/index.d.ts +1 -0
- package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.js +3 -0
- package/dist/esm/engine/frontend-components/index.js.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js +9 -4
- package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +4 -4
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +34 -0
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +26 -0
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +2 -2
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts +9 -0
- package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js +122 -0
- package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts +9 -0
- package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js +152 -0
- package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts +10 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js +94 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts +10 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js +64 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts +4 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js +20 -16
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts +9 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js +200 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +19 -6
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts +9 -0
- package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js +97 -0
- package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js.map +1 -0
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts +8 -0
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +2 -2
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +8 -8
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js +4 -4
- package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts +9 -0
- package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js +153 -0
- package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js.map +1 -0
- package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts +81 -0
- package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js +437 -0
- package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js.map +1 -0
- package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts +112 -0
- package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js +287 -0
- package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js.map +1 -0
- package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts +131 -0
- package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js +594 -0
- package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js.map +1 -0
- package/dist/esm/engine/notifications/resources/index.d.ts +1 -0
- package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/index.js +1 -0
- package/dist/esm/engine/notifications/resources/index.js.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts +6 -3
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -5
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +12 -2
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts +6 -6
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +8 -11
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts +4 -0
- package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts.map +1 -0
- package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js +62 -0
- package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js.map +1 -0
- package/dist/esm/engine/notifications/system-emails/index.d.ts +2 -1
- package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/index.js +4 -2
- package/dist/esm/engine/notifications/system-emails/index.js.map +1 -1
- package/dist/esm/engine/organizations/resources/index.d.ts +2 -0
- package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/index.js +2 -0
- package/dist/esm/engine/organizations/resources/index.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +3 -0
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +40 -12
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +2 -2
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +2 -2
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts +0 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +4 -6
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +7 -3
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +15 -8
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts +3 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +36 -21
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts +38 -0
- package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js +152 -0
- package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js.map +1 -0
- package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts +106 -0
- package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js +417 -0
- package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js.map +1 -0
- package/dist/esm/engine/providers/apple.provider.specification.js +1 -1
- package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/github.provider.specification.js +1 -1
- package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/google-places.provider.specification.d.ts +6 -0
- package/dist/esm/engine/providers/google-places.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/google-places.provider.specification.js +44 -0
- package/dist/esm/engine/providers/google-places.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/google.provider.specification.js +1 -1
- package/dist/esm/engine/providers/google.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/index.d.ts +2 -0
- package/dist/esm/engine/providers/index.d.ts.map +1 -1
- package/dist/esm/engine/providers/index.js +5 -1
- package/dist/esm/engine/providers/index.js.map +1 -1
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/microsoft.provider.specification.js +10 -6
- package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts +6 -0
- package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/recaptcha.provider.specification.js +38 -0
- package/dist/esm/engine/providers/recaptcha.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/resend.provider.specification.js +3 -1
- package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/stripe.provider.specification.js +3 -2
- package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -1
- package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts +2 -0
- package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts.map +1 -0
- package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js +21 -0
- package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js.map +1 -0
- package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts +2 -0
- package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts.map +1 -0
- package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js +21 -0
- package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js.map +1 -0
- package/dist/esm/engine/roles/index.d.ts +13 -5
- package/dist/esm/engine/roles/index.d.ts.map +1 -1
- package/dist/esm/engine/roles/index.js +19 -6
- package/dist/esm/engine/roles/index.js.map +1 -1
- package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts +2 -0
- package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts.map +1 -0
- package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js +21 -0
- package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js.map +1 -0
- package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts +7 -0
- package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts.map +1 -0
- package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js +72 -0
- package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js.map +1 -0
- package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts +2 -0
- package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts.map +1 -0
- package/dist/esm/engine/roles/org-service-provider.role.specification.js +22 -0
- package/dist/esm/engine/roles/org-service-provider.role.specification.js.map +1 -0
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +3 -3
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts +1 -1
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js +3 -6
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts +0 -4
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js +0 -3
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +0 -3
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +7 -7
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +5 -5
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +0 -3
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +11 -18
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +6 -6
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js +5 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.d.ts +8 -5
- package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.js +49 -16
- package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +29 -10
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +8 -8
- package/dist/assurance/external-framework-mapping.json +0 -1228
package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { appApiKeysApplicationAdminResourceUIBehavior as appApiKeysUIBehaviorSource } from '@wildo-ai/presets-components';
|
|
2
2
|
import { LabelAudience } from '@wildo-ai/presets-components-models';
|
|
3
3
|
import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
|
|
4
|
-
import { ApiKeyApplicationSchema, ApiKeyScope, ApiKeyStatus, AppApiKeys_Operations, CORE_APP_ROLES, CoreResourceOperation as Op, ResourcePrimaryScope, appApiKeysResourceConfiguration_InitializationFactory as appApiKeysFactory, } from '@wildo-ai/saas-models';
|
|
4
|
+
import { ApiKeyApplicationSchema, ApiKeyScope, ApiKeyStatus, AppApiKeys_Operations, CORE_APP_ROLES, CoreResourceOperation as Op, ResourcePrimaryScope, appApiKeysResourceConfiguration_InitializationFactory as appApiKeysFactory, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
|
|
5
5
|
import { HttpResponseStatusCode, resourceFrontendConfiguration, resourceSpecification, resourceSpecificationFromFrontendConfiguration, } from '../../../_core/index.js';
|
|
6
6
|
import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
|
|
7
7
|
const appApiKeysUIBehavior = appApiKeysUIBehaviorSource;
|
|
@@ -119,9 +119,20 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
119
119
|
}),
|
|
120
120
|
applicationId: schemaShape.applicationId.stringSpec({ meaning: 'Immutable owning application for this key record.' }),
|
|
121
121
|
expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Optional hard stop for validity.' }),
|
|
122
|
+
lastUsedAt: schemaShape.lastUsedAt.dateSpec({
|
|
123
|
+
meaning: 'When the key was last accepted, to the minute. Absent when it has never been used.',
|
|
124
|
+
whyItMatters: 'It is how an administrator finds keys nobody uses any more, which are the first to revoke. Written by the application each time the key authenticates a request, at most once a minute, and never counted as a change to the key.',
|
|
125
|
+
}),
|
|
122
126
|
previousKeyInvalidationDate: schemaShape.previousKeyInvalidationDate.dateSpec({
|
|
123
127
|
meaning: 'After a rotation, when the PRIOR secret stops authenticating; during this grace window both secrets work so integrations can migrate without downtime (absent/null after a regenerate = prior secret valid until the next rotation).',
|
|
124
128
|
}),
|
|
129
|
+
previousKeyPrefix: schemaShape.previousKeyPrefix.stringSpec({
|
|
130
|
+
meaning: 'The first 8 characters of the secret this key had before its last rotation or regeneration, so that value can still be recognised. Absent until the key is first reissued.',
|
|
131
|
+
whyItMatters: 'Shown only while that previous secret still authenticates. When no end date is shown beside it — after a regenerate — it keeps working until the key is rotated or regenerated again, so an integration still using it is not cut off, and a leaked old secret is not revoked by regenerating.',
|
|
132
|
+
}),
|
|
133
|
+
description: schemaShape.description.stringSpec({
|
|
134
|
+
meaning: 'Optional note on what the key is for, up to 500 characters.',
|
|
135
|
+
}),
|
|
125
136
|
},
|
|
126
137
|
operations: {
|
|
127
138
|
[Op.READ]: {
|
|
@@ -186,7 +197,7 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
186
197
|
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The key was minted; the response carries the one-time plaintext secret alongside the persisted metadata.' },
|
|
187
198
|
],
|
|
188
199
|
errorScenarios: [
|
|
189
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The key name, roles, or expiry payload fails schema validation.'
|
|
200
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The key name, roles, or expiry payload fails schema validation.' },
|
|
190
201
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; minting keys is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },
|
|
191
202
|
],
|
|
192
203
|
idempotent: false,
|
|
@@ -227,9 +238,9 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
227
238
|
{ code: HttpResponseStatusCode.OK_200, meaning: 'The key was rotated; the response carries the new one-time plaintext and the old-material cutover fields.' },
|
|
228
239
|
],
|
|
229
240
|
errorScenarios: [
|
|
230
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.'
|
|
241
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.' },
|
|
231
242
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; rotation is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },
|
|
232
|
-
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous key becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.',
|
|
243
|
+
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous key becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.', customMessageReference: ErrorCustomMessageReference.STEP_UP_REQUIRED },
|
|
233
244
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },
|
|
234
245
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is in a state where rotation is not allowed (e.g. it is already inactive or expired).' },
|
|
235
246
|
],
|
|
@@ -344,7 +355,7 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
344
355
|
{ code: HttpResponseStatusCode.OK_200, meaning: 'The key’s `expiresAt` was moved to the requested later instant and the updated record is returned.' },
|
|
345
356
|
],
|
|
346
357
|
errorScenarios: [
|
|
347
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The new expiry instant is missing or fails schema validation.'
|
|
358
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The new expiry instant is missing or fails schema validation.' },
|
|
348
359
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; extending expiry is `APP_ADMIN_SUPER_ADMIN`-only.' },
|
|
349
360
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },
|
|
350
361
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The key has no `expiresAt` value, so there is no existing expiry to extend.' },
|
|
@@ -359,10 +370,10 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
359
370
|
},
|
|
360
371
|
[AppApiKeys_Operations.USAGE_STATS]: {
|
|
361
372
|
operationId: AppApiKeys_Operations.USAGE_STATS,
|
|
362
|
-
purpose: '
|
|
363
|
-
outcome: 'The
|
|
373
|
+
purpose: 'Report how an application API key has been used, so an administrator can find stale or unexpectedly busy keys.',
|
|
374
|
+
outcome: 'The key\u2019s recorded use: requests authenticated with it over the last hour, day and week, the share of them that failed, the route it reached most, and when it was last accepted. Every door that accepts a key records its use; counts are a rolling week, not a lifetime ledger, and a lifetime total and a rate-limit count are not reported because nothing can answer them truthfully.',
|
|
364
375
|
responseStatuses: [
|
|
365
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: '
|
|
376
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The key\u2019s usage statistics are returned. A key never used reports zero counts and no `lastUsedAt`.' },
|
|
366
377
|
],
|
|
367
378
|
errorScenarios: [
|
|
368
379
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; usage analytics are `APP_ADMIN_SUPER_ADMIN`-only.' },
|
|
@@ -370,15 +381,15 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
370
381
|
],
|
|
371
382
|
idempotent: true,
|
|
372
383
|
examples: [{
|
|
373
|
-
title: '
|
|
384
|
+
title: 'A key in regular use',
|
|
374
385
|
response: {
|
|
375
386
|
keyId: APPLICATION_API_KEY_RECORD_EXAMPLE._id,
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
387
|
+
requestsLastHour: 12,
|
|
388
|
+
requestsLastDay: 240,
|
|
389
|
+
requestsLastWeek: 1480,
|
|
390
|
+
lastUsedAt: '2026-09-27T09:58:00.000Z',
|
|
391
|
+
mostUsedEndpoint: 'GET /api/v1/organizations/:organizationId/todos',
|
|
392
|
+
errorRate: 1.35,
|
|
382
393
|
},
|
|
383
394
|
forStatus: HttpResponseStatusCode.OK_200,
|
|
384
395
|
}],
|
|
@@ -394,31 +405,22 @@ export const applicationApiKeysResourceSpecification = resourceSpecificationFrom
|
|
|
394
405
|
purpose: 'Use the `name` field as the primary list/detail label, consistent with the app-admin UI behavior.',
|
|
395
406
|
},
|
|
396
407
|
layout: {
|
|
397
|
-
purpose: '
|
|
398
|
-
displayPurpose: '
|
|
408
|
+
purpose: 'Two groupings on the read page: what the key is and may do (`overview`), and its validity and use (`lifecycle`). The name and status are the page header, so neither is a row.',
|
|
409
|
+
displayPurpose: 'The header carries the key name and its status badge. `overview` is an untitled card of the key prefix, the description (hidden when empty) and the roles; `lifecycle` holds expiry and last use (each hidden when empty), creation, and, only while the previous secret still authenticates after a rotation, that secret\'s prefix and end date. No read section shows a description. `scope` is not laid out: on this resource it is always `application`. The form is one flat list — name (focused), description as a paragraph, status, expiry, roles — with no section headings.',
|
|
410
|
+
summaryPurpose: 'A card titled with the key name, then its status badge, its prefix, and its expiry labelled (a bare date could be any of the key\'s dates).',
|
|
399
411
|
sections: {
|
|
400
412
|
overview: {
|
|
401
|
-
purpose: '
|
|
402
|
-
whenToUse: '
|
|
403
|
-
textSlots: {
|
|
404
|
-
title: { purpose: 'Label the key identity and status area.' },
|
|
405
|
-
description: { purpose: 'Reiterate that only a prefix, not a secret, is ever shown in routine views.' },
|
|
406
|
-
},
|
|
407
|
-
},
|
|
408
|
-
access: {
|
|
409
|
-
purpose: 'Roles and description of what this app key is for.',
|
|
410
|
-
whenToUse: 'Explaining and editing integration scope in app admin.',
|
|
413
|
+
purpose: 'Key prefix, description and roles: what the key is and what it may do.',
|
|
414
|
+
whenToUse: 'The first block of a single key\'s read page.',
|
|
411
415
|
textSlots: {
|
|
412
|
-
title: { purpose: '
|
|
413
|
-
description: { purpose: 'Tie the key’s roles to least-privilege expectations for the integration user.' },
|
|
416
|
+
title: { purpose: 'Name the key-identity block. Not rendered on the read page, where the header already names the key.' },
|
|
414
417
|
},
|
|
415
418
|
},
|
|
416
419
|
lifecycle: {
|
|
417
|
-
purpose: 'Expiry, last use
|
|
418
|
-
whenToUse: '
|
|
420
|
+
purpose: 'Expiry, last use and creation; and, while a rotated key\'s previous secret still authenticates, that secret\'s prefix and when it stops (after a regenerate it has no end date and keeps working until the next rotation, which the prefix row\'s description says).',
|
|
421
|
+
whenToUse: 'Judging whether a key is still live, and when it was last used.',
|
|
419
422
|
textSlots: {
|
|
420
|
-
title: { purpose: 'Label the
|
|
421
|
-
description: { purpose: 'Clarify that rotation history is not a substitute for a secret vault.' },
|
|
423
|
+
title: { purpose: 'Label the validity and usage block.' },
|
|
422
424
|
},
|
|
423
425
|
},
|
|
424
426
|
},
|
package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"application-api-keys.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-api-keys.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { appApiKeysApplicationAdminResourceUIBehavior as appApiKeysUIBehaviorSource } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ApiKeyApplicationSchema,\n ApiKeyScope,\n ApiKeyStatus,\n AppApiKeys_Operations,\n CORE_APP_ROLES,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n appApiKeysResourceConfiguration_InitializationFactory as appApiKeysFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof appApiKeysFactory>;\ntype Custom = NonNullable<Cfg['customOperation']>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\n\nconst appApiKeysUIBehavior = appApiKeysUIBehaviorSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\n\nconst APPLICATION_API_KEY_RECORD_EXAMPLE = {\n _id: 'appkey_01JEXAMPLE',\n name: 'Customer provisioning worker',\n description: 'Application-level credential for the tenant provisioning automation.',\n scope: ApiKeyScope.APPLICATION,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n status: ApiKeyStatus.ACTIVE,\n expiresAt: '2099-06-15T00:00:00.000Z',\n lastUsedAt: '2026-08-18T09:48:00.000Z',\n createdAt: '2026-07-01T08:00:00.000Z',\n updatedAt: '2026-08-18T09:48:00.000Z',\n applicationId: 'app_01JEXAMPLE',\n keyPrefix: 'sk_app_a',\n} as const;\n\nconst APPLICATION_API_KEY_PAGE_EXAMPLE = {\n data: [APPLICATION_API_KEY_RECORD_EXAMPLE],\n pagination: { page: 1, limit: 20, total: 1, totalPages: 1 },\n} as const;\n\n/**\n * Application API keys: UI is authored under `buildApplicationAdminPresets` in\n * `application.resource-presets.tsx` (tab under app admin) — not in `security` presets.\n */\nexport const applicationApiKeysResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n resourceFrontendConfiguration(appApiKeysUIBehavior),\n resourceSpecification(\n appApiKeysFactory,\n ApiKeyApplicationSchema,\n ({ schemaShape }) => ({\n purpose: 'Application-scoped API keys: secrets for calling backend APIs in app-level automation and integration contexts.',\n businessRole: 'App-admin credential distinct from end-user sessions and from organization keys.',\n lifecycleRole: 'Created, rotated and deactivated by application administrators; ordinary application members cannot manage these credentials. Per-key request analytics are not currently recorded.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.APPLICATIONS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApiKeyApplicationSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'appApiKeysResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'APPLICATION_API_KEYS',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n customEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AppApiKeys_Operations',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'appApiKeysApplicationAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n },\n fields: {\n name: schemaShape.name.stringSpec({\n meaning: 'Label for the key in app-admin UI.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n status: schemaShape.status.enumSpec({\n meaning: 'Whether the app key is allowed to authenticate.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApiKeyStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ApiKeyStatus.ACTIVE]: { meaning: 'Key may be used within policy and expiry.' },\n [ApiKeyStatus.INACTIVE]: { meaning: 'Revoked or disabled; authentications should fail.' },\n [ApiKeyStatus.EXPIRED]: { meaning: 'Past its validity window; treat as invalid.' },\n },\n }),\n keyPrefix: schemaShape.keyPrefix.stringSpec({\n meaning: 'Short prefix for support correlation (not the full secret).',\n }),\n roles: schemaShape.roles.arraySpec({\n meaning: 'Roles embedded on the key; every request authenticated with it inherits exactly these roles, bounding what the integration can do (least-privilege for automation).',\n elementMeaning: 'One role identifier — a core app/org role token or an app-defined custom role string.',\n // Element is a union of `CORE_APP_ROLES` + `CORE_ORG_ROLES` + a free\n // custom-role string; the shape validator requires ONE enum vocabulary\n // to advertise, so we name the app-scope enum (the primary vocabulary\n // for an application key). Org tokens and custom strings remain valid\n // per `elementMeaning`.\n elementType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CORE_APP_ROLES',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n }),\n applicationId: schemaShape.applicationId.stringSpec({ meaning: 'Immutable owning application for this key record.' }),\n expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Optional hard stop for validity.' }),\n previousKeyInvalidationDate: schemaShape.previousKeyInvalidationDate.dateSpec({\n meaning: 'After a rotation, when the PRIOR secret stops authenticating; during this grace window both secrets work so integrations can migrate without downtime (absent/null after a regenerate = prior secret valid until the next rotation).',\n }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect a single app key without exposing the hashed secret in responses.',\n outcome: 'The key metadata is returned to an application super administrator; secret material is never returned by this operation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key metadata (never the hashed secret) was found and returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; every public variant of this resource is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n ],\n idempotent: true,\n examples: [{ title: 'Inspect an application automation key', response: APPLICATION_API_KEY_RECORD_EXAMPLE, forStatus: HttpResponseStatusCode.OK_200 }],\n variants: {\n context: { examples: [] },\n summary: { examples: [] },\n },\n },\n [Op.LIST]: {\n purpose: 'List keys in app scope for admin users.',\n outcome: 'Rows in the app-admin key tab and related entry points.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of app keys in the caller’s application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; key inventory is `APP_ADMIN_SUPER_ADMIN`-only.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Browse application automation keys',\n request: { page: 1, limit: 20, sort: 'createdAt:desc' },\n response: APPLICATION_API_KEY_PAGE_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: { examples: [] },\n summary: { examples: [] },\n },\n },\n [Op.SEARCH]: {\n purpose: 'Find application API keys by the documented administrative filters and sort order.',\n outcome: 'Narrowing large key sets with admin-only filter fields.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of app keys matching the admin filter/sort criteria.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; the admin search variant is `APP_ADMIN_SUPER_ADMIN`-only.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Find active expiring provisioning keys',\n request: { q: 'provisioning', status: ApiKeyStatus.ACTIVE, hasExpiration: true, page: 1, limit: 20, sort: 'lastUsedAt:desc' },\n response: APPLICATION_API_KEY_PAGE_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [Op.CREATE]: {\n purpose: 'Create a new application API key for an integration or automation client.',\n outcome: 'The key is created, application administrators are notified, and its plaintext value is returned exactly once. Later reads expose only its prefix.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The key was minted; the response carries the one-time plaintext secret alongside the persisted metadata.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The key name, roles, or expiry payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; minting keys is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },\n ],\n idempotent: false,\n rateLimitNote: 'Key minting is high-risk credential issuance and is rate-limited per application to slow credential-spraying and accidental bulk creation.',\n examples: [\n {\n title: 'Mint an application API key',\n request: {\n name: 'Customer provisioning worker',\n description: 'Application-level credential for the tenant provisioning automation.',\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n status: ApiKeyStatus.ACTIVE,\n expiresAt: '2099-06-15T00:00:00.000Z',\n },\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n hashedKey: '5200d0cc738d17e85e00689b77528b1194623ef0f6793739a8a477fe66c59ca1',\n plainKey: 'sk_app_a_example-secret-returned-once',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.DELETE]: {\n purpose: 'Repository-only teardown of the application API-key row when its owning application is deleted (composition `onParentDelete` cascade).',\n outcome: 'Every API key under the application is removed together with the application — the composition parts do not outlive their whole.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The application API-key record was deleted as part of the owning application’s deletion cascade.' },\n ],\n // REPOSITORY_ONLY variant (APP_ADMIN_SUPER_ADMIN) — invoked by the onParentDelete cascade, not a public HTTP endpoint, so no client-facing 400/403/404 are documented.\n idempotent: true,\n },\n [AppApiKeys_Operations.ROTATE]: {\n operationId: AppApiKeys_Operations.ROTATE,\n purpose: 'Reissue a key with invalidation of the old material at a specified boundary.',\n outcome: 'The new plaintext key is returned exactly once. The previous key remains valid until the requested invalidation time so integrations can migrate without downtime.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key was rotated; the response carries the new one-time plaintext and the old-material cutover fields.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; rotation is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous key becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.', errorCode: 'STEP_UP_REQUIRED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is in a state where rotation is not allowed (e.g. it is already inactive or expired).' },\n ],\n idempotent: false,\n rateLimitNote: 'Rotation issues fresh secret material and is rate-limited per key to prevent rapid re-rotation that would churn the credential cutover window.',\n examples: [\n {\n title: 'Rotate a key with a cutover window',\n request: {\n oldKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n },\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n keyPrefix: 'sk_app_b',\n previousKeyPrefix: APPLICATION_API_KEY_RECORD_EXAMPLE.keyPrefix,\n previousKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n plainKey: 'sk_app_b_example-secret-returned-once',\n oldKeyId: APPLICATION_API_KEY_RECORD_EXAMPLE._id,\n oldKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n [AppApiKeys_Operations.REGENERATE]: {\n operationId: AppApiKeys_Operations.REGENERATE,\n purpose: 'Generate a new secret without the full rotate lifecycle semantics.',\n outcome: 'The new plaintext key is returned exactly once, administrators are notified, and the previous key remains valid until a later rotation completes the cutover.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A fresh secret was generated for the existing key record; the response carries the new one-time plaintext.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; regeneration is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is in a state where regenerating the secret is not allowed (e.g. it is inactive or expired).' },\n ],\n idempotent: false,\n rateLimitNote: 'Secret regeneration is rate-limited per key for the same credential-hygiene reasons as rotation.',\n examples: [{\n title: 'Regenerate with an open migration overlap',\n request: {},\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n keyPrefix: 'sk_app_c',\n previousKeyPrefix: APPLICATION_API_KEY_RECORD_EXAMPLE.keyPrefix,\n plainKey: 'sk_app_c_example-secret-returned-once',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n /**\n * INTERNAL_CALL, so this entry documents SEMANTICS and deliberately carries no HTTP\n * response statuses, error scenarios or examples: there is no route to call and no\n * response a consumer receives. Authoring a `200 OK` example here would document a door\n * that does not exist, which is worse than the silence.\n */\n [AppApiKeys_Operations.EXPIRE]: {\n operationId: AppApiKeys_Operations.EXPIRE,\n purpose: 'Record that a key’s validity window has elapsed, so a listing shows it as expired rather than active.',\n outcome: 'Status becomes expired. Nothing about authentication changes — the key already stopped working the instant its expiry passed.',\n whenToUse: 'Never called directly. The nightly credential-expiry sweep dispatches it; an administrator who wants a key gone sooner deactivates it, and one who wants it to last longer extends its expiry.',\n },\n [AppApiKeys_Operations.DEACTIVATE]: {\n operationId: AppApiKeys_Operations.DEACTIVATE,\n purpose: 'Disable an active key in place for policy or incident control.',\n outcome: 'Key becomes inactive; may notify administrators.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key is inactive and the updated record is returned. This operation accepts an empty JSON object.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; deactivation is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is already inactive or expired, so deactivation is not a legal transition.' },\n ],\n // NOT idempotent: the ACTIVE precondition flips on the first call, so a repeat is the\n // 409 above rather than a second 200.\n idempotent: false,\n examples: [{\n title: 'Deactivate a compromised application key',\n request: {},\n response: { ...APPLICATION_API_KEY_RECORD_EXAMPLE, status: ApiKeyStatus.INACTIVE },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.REACTIVATE]: {\n operationId: AppApiKeys_Operations.REACTIVATE,\n purpose: 'Re-enable a key that is currently inactive.',\n outcome: 'Key returns to active for permitted flows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key is active again and the updated record is returned. This operation accepts an empty JSON object.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; reactivation is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is expired or already active, so reactivation is not a legal transition.' },\n ],\n // NOT idempotent: the INACTIVE precondition flips on the first call, so a repeat is the\n // 409 above rather than a second 200.\n idempotent: false,\n examples: [{\n title: 'Reactivate a remediated application key',\n request: {},\n response: APPLICATION_API_KEY_RECORD_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.EXTEND_EXPIRY]: {\n operationId: AppApiKeys_Operations.EXTEND_EXPIRY,\n purpose: 'Postpone expiry for a key that already has an expiration date.',\n outcome: 'New expiry instant stored on the row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key’s `expiresAt` was moved to the requested later instant and the updated record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The new expiry instant is missing or fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; extending expiry is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key has no `expiresAt` value, so there is no existing expiry to extend.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Extend a key before its scheduled expiry',\n request: { newExpiresAt: '2099-12-31T00:00:00.000Z' },\n response: { ...APPLICATION_API_KEY_RECORD_EXAMPLE, expiresAt: '2099-12-31T00:00:00.000Z' },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.USAGE_STATS]: {\n operationId: AppApiKeys_Operations.USAGE_STATS,\n purpose: 'Return the current application API-key usage-statistics response contract.',\n outcome: 'The current runtime has no per-key usage data source and returns an explicit all-zero placeholder; it must not be interpreted as proof that the key was unused.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A schema-valid all-zero placeholder is returned until per-key usage tracking is implemented.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; usage analytics are `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Current all-zero placeholder',\n response: {\n keyId: APPLICATION_API_KEY_RECORD_EXAMPLE._id,\n totalRequests: 0,\n requestsLastHour: 0,\n requestsLastDay: 0,\n requestsLastWeek: 0,\n errorRate: 0,\n rateLimitHits: 0,\n },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n businessConstraints: [\n 'All public HTTP operation variants in the factory are restricted to `APP_ADMIN_SUPER_ADMIN`; do not model member-level access in companion flows.',\n 'Plaintext is only on create/rotate/regenerate responses; avoid implying clients can re-download full secrets from READ.',\n 'ROTATE/REGENERATE keep the prior secret authenticating during a grace window (rotate: until `previousKeyInvalidationDate`; regenerate: until the next rotation); bearer-token auth accepts the current OR the not-yet-invalidated previous secret.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n ),\n () => ({\n label: {\n purpose: 'Use the `name` field as the primary list/detail label, consistent with the app-admin UI behavior.',\n },\n layout: {\n purpose: 'Overview, access, and lifecycle groupings in `application` admin presets (same section ids as org keys for cognitive parity).',\n displayPurpose: 'Read and edit share `overview` / `access` / `lifecycle` section refs; create omits a full `lifecycle` block in the edit form per preset code.',\n sections: {\n overview: {\n purpose: 'Name, scope, status, and key prefix in one scan.',\n whenToUse: 'List summaries, read-only, and the create form’s top card.',\n textSlots: {\n title: { purpose: 'Label the key identity and status area.' },\n description: { purpose: 'Reiterate that only a prefix, not a secret, is ever shown in routine views.' },\n },\n },\n access: {\n purpose: 'Roles and description of what this app key is for.',\n whenToUse: 'Explaining and editing integration scope in app admin.',\n textSlots: {\n title: { purpose: 'Label the access block.' },\n description: { purpose: 'Tie the key’s roles to least-privilege expectations for the integration user.' },\n },\n },\n lifecycle: {\n purpose: 'Expiry, last use, and creation timestamps in read and summary templates.',\n whenToUse: 'Read-only in display/summary; create flow focuses on `overview` + `access` per preset implementation.',\n textSlots: {\n title: { purpose: 'Label the lifecycle and usage strip in read mode.' },\n description: { purpose: 'Clarify that rotation history is not a substitute for a secret vault.' },\n },\n },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Primary navigation within app admin when keys are a tab/section; non-addressable in the preset’s view wiring but still the inventory surface for operators.', whenToUse: 'App super-admin app detail → API keys tab.' },\n [Op.READ]: { purpose: 'Read shell for a single app key; non-addressable in default preset list.', whenToUse: 'Drill-in from the key list in app admin UIs when routes expose READ.' },\n [Op.CREATE]: { purpose: 'Create a new app key; plaintext appears only in the create response on success per factory DTOs.', whenToUse: 'First-time integration and additional automation credentials.' },\n [Op.SEARCH]: { purpose: 'Admin search with filter fields defined in the factory for app keys.', whenToUse: 'Finding a key in apps with many credentials.' },\n [AppApiKeys_Operations.ROTATE]: { purpose: 'Rotation workflow; not addressable in default preset `views` array.', whenToUse: 'Security and incident rotation from a key detail or action surface when wired.' },\n [AppApiKeys_Operations.REGENERATE]: { purpose: 'Lighter reissue of secret material; non-addressable in default preset `views` array.', whenToUse: 'When overlap between old and new is acceptable; email notifications may fire.' },\n [AppApiKeys_Operations.DEACTIVATE]: { purpose: 'Disable an active key in place; status-gated in the factory enablement check.', whenToUse: 'Stop traffic for a compromised or obsolete integration key.' },\n [AppApiKeys_Operations.REACTIVATE]: { purpose: 'Undo deactivation for policy-approved reuse.', whenToUse: 'When a key was turned off temporarily rather than deleted.' },\n [AppApiKeys_Operations.EXTEND_EXPIRY]: { purpose: 'Push expiry for keys that have an expiration set.', whenToUse: 'Before automated expiry to avoid service outage.' },\n [AppApiKeys_Operations.USAGE_STATS]: { purpose: 'Usage analytics view for a key; not addressable in default preset `views` array.', whenToUse: 'Admin troubleshooting and SLO review.' },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"application-api-keys.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-api-keys.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { appApiKeysApplicationAdminResourceUIBehavior as appApiKeysUIBehaviorSource } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ApiKeyApplicationSchema,\n ApiKeyScope,\n ApiKeyStatus,\n AppApiKeys_Operations,\n CORE_APP_ROLES,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n appApiKeysResourceConfiguration_InitializationFactory as appApiKeysFactory,\n ErrorCustomMessageReference,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof appApiKeysFactory>;\ntype Custom = NonNullable<Cfg['customOperation']>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\n\nconst appApiKeysUIBehavior = appApiKeysUIBehaviorSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\n\nconst APPLICATION_API_KEY_RECORD_EXAMPLE = {\n _id: 'appkey_01JEXAMPLE',\n name: 'Customer provisioning worker',\n description: 'Application-level credential for the tenant provisioning automation.',\n scope: ApiKeyScope.APPLICATION,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n status: ApiKeyStatus.ACTIVE,\n expiresAt: '2099-06-15T00:00:00.000Z',\n lastUsedAt: '2026-08-18T09:48:00.000Z',\n createdAt: '2026-07-01T08:00:00.000Z',\n updatedAt: '2026-08-18T09:48:00.000Z',\n applicationId: 'app_01JEXAMPLE',\n keyPrefix: 'sk_app_a',\n} as const;\n\nconst APPLICATION_API_KEY_PAGE_EXAMPLE = {\n data: [APPLICATION_API_KEY_RECORD_EXAMPLE],\n pagination: { page: 1, limit: 20, total: 1, totalPages: 1 },\n} as const;\n\n/**\n * Application API keys: UI is authored under `buildApplicationAdminPresets` in\n * `application.resource-presets.tsx` (tab under app admin) — not in `security` presets.\n */\nexport const applicationApiKeysResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n resourceFrontendConfiguration(appApiKeysUIBehavior),\n resourceSpecification(\n appApiKeysFactory,\n ApiKeyApplicationSchema,\n ({ schemaShape }) => ({\n purpose: 'Application-scoped API keys: secrets for calling backend APIs in app-level automation and integration contexts.',\n businessRole: 'App-admin credential distinct from end-user sessions and from organization keys.',\n lifecycleRole: 'Created, rotated and deactivated by application administrators; ordinary application members cannot manage these credentials. Per-key request analytics are not currently recorded.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.APPLICATIONS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApiKeyApplicationSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'appApiKeysResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'APPLICATION_API_KEYS',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n customEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AppApiKeys_Operations',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'appApiKeysApplicationAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n },\n fields: {\n name: schemaShape.name.stringSpec({\n meaning: 'Label for the key in app-admin UI.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n status: schemaShape.status.enumSpec({\n meaning: 'Whether the app key is allowed to authenticate.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApiKeyStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ApiKeyStatus.ACTIVE]: { meaning: 'Key may be used within policy and expiry.' },\n [ApiKeyStatus.INACTIVE]: { meaning: 'Revoked or disabled; authentications should fail.' },\n [ApiKeyStatus.EXPIRED]: { meaning: 'Past its validity window; treat as invalid.' },\n },\n }),\n keyPrefix: schemaShape.keyPrefix.stringSpec({\n meaning: 'Short prefix for support correlation (not the full secret).',\n }),\n roles: schemaShape.roles.arraySpec({\n meaning: 'Roles embedded on the key; every request authenticated with it inherits exactly these roles, bounding what the integration can do (least-privilege for automation).',\n elementMeaning: 'One role identifier — a core app/org role token or an app-defined custom role string.',\n // Element is a union of `CORE_APP_ROLES` + `CORE_ORG_ROLES` + a free\n // custom-role string; the shape validator requires ONE enum vocabulary\n // to advertise, so we name the app-scope enum (the primary vocabulary\n // for an application key). Org tokens and custom strings remain valid\n // per `elementMeaning`.\n elementType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CORE_APP_ROLES',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n }),\n applicationId: schemaShape.applicationId.stringSpec({ meaning: 'Immutable owning application for this key record.' }),\n expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Optional hard stop for validity.' }),\n lastUsedAt: schemaShape.lastUsedAt.dateSpec({\n meaning: 'When the key was last accepted, to the minute. Absent when it has never been used.',\n whyItMatters: 'It is how an administrator finds keys nobody uses any more, which are the first to revoke. Written by the application each time the key authenticates a request, at most once a minute, and never counted as a change to the key.',\n }),\n previousKeyInvalidationDate: schemaShape.previousKeyInvalidationDate.dateSpec({\n meaning: 'After a rotation, when the PRIOR secret stops authenticating; during this grace window both secrets work so integrations can migrate without downtime (absent/null after a regenerate = prior secret valid until the next rotation).',\n }),\n previousKeyPrefix: schemaShape.previousKeyPrefix.stringSpec({\n meaning: 'The first 8 characters of the secret this key had before its last rotation or regeneration, so that value can still be recognised. Absent until the key is first reissued.',\n whyItMatters: 'Shown only while that previous secret still authenticates. When no end date is shown beside it — after a regenerate — it keeps working until the key is rotated or regenerated again, so an integration still using it is not cut off, and a leaked old secret is not revoked by regenerating.',\n }),\n description: schemaShape.description.stringSpec({\n meaning: 'Optional note on what the key is for, up to 500 characters.',\n }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect a single app key without exposing the hashed secret in responses.',\n outcome: 'The key metadata is returned to an application super administrator; secret material is never returned by this operation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key metadata (never the hashed secret) was found and returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; every public variant of this resource is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n ],\n idempotent: true,\n examples: [{ title: 'Inspect an application automation key', response: APPLICATION_API_KEY_RECORD_EXAMPLE, forStatus: HttpResponseStatusCode.OK_200 }],\n variants: {\n context: { examples: [] },\n summary: { examples: [] },\n },\n },\n [Op.LIST]: {\n purpose: 'List keys in app scope for admin users.',\n outcome: 'Rows in the app-admin key tab and related entry points.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of app keys in the caller’s application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; key inventory is `APP_ADMIN_SUPER_ADMIN`-only.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Browse application automation keys',\n request: { page: 1, limit: 20, sort: 'createdAt:desc' },\n response: APPLICATION_API_KEY_PAGE_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: { examples: [] },\n summary: { examples: [] },\n },\n },\n [Op.SEARCH]: {\n purpose: 'Find application API keys by the documented administrative filters and sort order.',\n outcome: 'Narrowing large key sets with admin-only filter fields.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of app keys matching the admin filter/sort criteria.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; the admin search variant is `APP_ADMIN_SUPER_ADMIN`-only.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Find active expiring provisioning keys',\n request: { q: 'provisioning', status: ApiKeyStatus.ACTIVE, hasExpiration: true, page: 1, limit: 20, sort: 'lastUsedAt:desc' },\n response: APPLICATION_API_KEY_PAGE_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [Op.CREATE]: {\n purpose: 'Create a new application API key for an integration or automation client.',\n outcome: 'The key is created, application administrators are notified, and its plaintext value is returned exactly once. Later reads expose only its prefix.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The key was minted; the response carries the one-time plaintext secret alongside the persisted metadata.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The key name, roles, or expiry payload fails schema validation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; minting keys is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },\n ],\n idempotent: false,\n rateLimitNote: 'Key minting is high-risk credential issuance and is rate-limited per application to slow credential-spraying and accidental bulk creation.',\n examples: [\n {\n title: 'Mint an application API key',\n request: {\n name: 'Customer provisioning worker',\n description: 'Application-level credential for the tenant provisioning automation.',\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n status: ApiKeyStatus.ACTIVE,\n expiresAt: '2099-06-15T00:00:00.000Z',\n },\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n hashedKey: '5200d0cc738d17e85e00689b77528b1194623ef0f6793739a8a477fe66c59ca1',\n plainKey: 'sk_app_a_example-secret-returned-once',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.DELETE]: {\n purpose: 'Repository-only teardown of the application API-key row when its owning application is deleted (composition `onParentDelete` cascade).',\n outcome: 'Every API key under the application is removed together with the application — the composition parts do not outlive their whole.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The application API-key record was deleted as part of the owning application’s deletion cascade.' },\n ],\n // REPOSITORY_ONLY variant (APP_ADMIN_SUPER_ADMIN) — invoked by the onParentDelete cascade, not a public HTTP endpoint, so no client-facing 400/403/404 are documented.\n idempotent: true,\n },\n [AppApiKeys_Operations.ROTATE]: {\n operationId: AppApiKeys_Operations.ROTATE,\n purpose: 'Reissue a key with invalidation of the old material at a specified boundary.',\n outcome: 'The new plaintext key is returned exactly once. The previous key remains valid until the requested invalidation time so integrations can migrate without downtime.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key was rotated; the response carries the new one-time plaintext and the old-material cutover fields.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; rotation is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous key becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.', customMessageReference: ErrorCustomMessageReference.STEP_UP_REQUIRED },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is in a state where rotation is not allowed (e.g. it is already inactive or expired).' },\n ],\n idempotent: false,\n rateLimitNote: 'Rotation issues fresh secret material and is rate-limited per key to prevent rapid re-rotation that would churn the credential cutover window.',\n examples: [\n {\n title: 'Rotate a key with a cutover window',\n request: {\n oldKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n },\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n keyPrefix: 'sk_app_b',\n previousKeyPrefix: APPLICATION_API_KEY_RECORD_EXAMPLE.keyPrefix,\n previousKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n plainKey: 'sk_app_b_example-secret-returned-once',\n oldKeyId: APPLICATION_API_KEY_RECORD_EXAMPLE._id,\n oldKeyInvalidationDate: '2099-01-02T00:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n [AppApiKeys_Operations.REGENERATE]: {\n operationId: AppApiKeys_Operations.REGENERATE,\n purpose: 'Generate a new secret without the full rotate lifecycle semantics.',\n outcome: 'The new plaintext key is returned exactly once, administrators are notified, and the previous key remains valid until a later rotation completes the cutover.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A fresh secret was generated for the existing key record; the response carries the new one-time plaintext.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; regeneration is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is in a state where regenerating the secret is not allowed (e.g. it is inactive or expired).' },\n ],\n idempotent: false,\n rateLimitNote: 'Secret regeneration is rate-limited per key for the same credential-hygiene reasons as rotation.',\n examples: [{\n title: 'Regenerate with an open migration overlap',\n request: {},\n response: {\n ...APPLICATION_API_KEY_RECORD_EXAMPLE,\n keyPrefix: 'sk_app_c',\n previousKeyPrefix: APPLICATION_API_KEY_RECORD_EXAMPLE.keyPrefix,\n plainKey: 'sk_app_c_example-secret-returned-once',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n /**\n * INTERNAL_CALL, so this entry documents SEMANTICS and deliberately carries no HTTP\n * response statuses, error scenarios or examples: there is no route to call and no\n * response a consumer receives. Authoring a `200 OK` example here would document a door\n * that does not exist, which is worse than the silence.\n */\n [AppApiKeys_Operations.EXPIRE]: {\n operationId: AppApiKeys_Operations.EXPIRE,\n purpose: 'Record that a key’s validity window has elapsed, so a listing shows it as expired rather than active.',\n outcome: 'Status becomes expired. Nothing about authentication changes — the key already stopped working the instant its expiry passed.',\n whenToUse: 'Never called directly. The nightly credential-expiry sweep dispatches it; an administrator who wants a key gone sooner deactivates it, and one who wants it to last longer extends its expiry.',\n },\n [AppApiKeys_Operations.DEACTIVATE]: {\n operationId: AppApiKeys_Operations.DEACTIVATE,\n purpose: 'Disable an active key in place for policy or incident control.',\n outcome: 'Key becomes inactive; may notify administrators.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key is inactive and the updated record is returned. This operation accepts an empty JSON object.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; deactivation is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is already inactive or expired, so deactivation is not a legal transition.' },\n ],\n // NOT idempotent: the ACTIVE precondition flips on the first call, so a repeat is the\n // 409 above rather than a second 200.\n idempotent: false,\n examples: [{\n title: 'Deactivate a compromised application key',\n request: {},\n response: { ...APPLICATION_API_KEY_RECORD_EXAMPLE, status: ApiKeyStatus.INACTIVE },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.REACTIVATE]: {\n operationId: AppApiKeys_Operations.REACTIVATE,\n purpose: 'Re-enable a key that is currently inactive.',\n outcome: 'Key returns to active for permitted flows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key is active again and the updated record is returned. This operation accepts an empty JSON object.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; reactivation is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key is expired or already active, so reactivation is not a legal transition.' },\n ],\n // NOT idempotent: the INACTIVE precondition flips on the first call, so a repeat is the\n // 409 above rather than a second 200.\n idempotent: false,\n examples: [{\n title: 'Reactivate a remediated application key',\n request: {},\n response: APPLICATION_API_KEY_RECORD_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.EXTEND_EXPIRY]: {\n operationId: AppApiKeys_Operations.EXTEND_EXPIRY,\n purpose: 'Postpone expiry for a key that already has an expiration date.',\n outcome: 'New expiry instant stored on the row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key’s `expiresAt` was moved to the requested later instant and the updated record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The new expiry instant is missing or fails schema validation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; extending expiry is `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The key has no `expiresAt` value, so there is no existing expiry to extend.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Extend a key before its scheduled expiry',\n request: { newExpiresAt: '2099-12-31T00:00:00.000Z' },\n response: { ...APPLICATION_API_KEY_RECORD_EXAMPLE, expiresAt: '2099-12-31T00:00:00.000Z' },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [AppApiKeys_Operations.USAGE_STATS]: {\n operationId: AppApiKeys_Operations.USAGE_STATS,\n purpose: 'Report how an application API key has been used, so an administrator can find stale or unexpectedly busy keys.',\n outcome: 'The key\\u2019s recorded use: requests authenticated with it over the last hour, day and week, the share of them that failed, the route it reached most, and when it was last accepted. Every door that accepts a key records its use; counts are a rolling week, not a lifetime ledger, and a lifetime total and a rate-limit count are not reported because nothing can answer them truthfully.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The key\\u2019s usage statistics are returned. A key never used reports zero counts and no `lastUsedAt`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; usage analytics are `APP_ADMIN_SUPER_ADMIN`-only.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app key exists for the supplied id in the caller’s application scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'A key in regular use',\n response: {\n keyId: APPLICATION_API_KEY_RECORD_EXAMPLE._id,\n requestsLastHour: 12,\n requestsLastDay: 240,\n requestsLastWeek: 1480,\n lastUsedAt: '2026-09-27T09:58:00.000Z',\n mostUsedEndpoint: 'GET /api/v1/organizations/:organizationId/todos',\n errorRate: 1.35,\n },\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n businessConstraints: [\n 'All public HTTP operation variants in the factory are restricted to `APP_ADMIN_SUPER_ADMIN`; do not model member-level access in companion flows.',\n 'Plaintext is only on create/rotate/regenerate responses; avoid implying clients can re-download full secrets from READ.',\n 'ROTATE/REGENERATE keep the prior secret authenticating during a grace window (rotate: until `previousKeyInvalidationDate`; regenerate: until the next rotation); bearer-token auth accepts the current OR the not-yet-invalidated previous secret.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n ),\n () => ({\n label: {\n purpose: 'Use the `name` field as the primary list/detail label, consistent with the app-admin UI behavior.',\n },\n layout: {\n purpose: 'Two groupings on the read page: what the key is and may do (`overview`), and its validity and use (`lifecycle`). The name and status are the page header, so neither is a row.',\n displayPurpose: 'The header carries the key name and its status badge. `overview` is an untitled card of the key prefix, the description (hidden when empty) and the roles; `lifecycle` holds expiry and last use (each hidden when empty), creation, and, only while the previous secret still authenticates after a rotation, that secret\\'s prefix and end date. No read section shows a description. `scope` is not laid out: on this resource it is always `application`. The form is one flat list — name (focused), description as a paragraph, status, expiry, roles — with no section headings.',\n summaryPurpose: 'A card titled with the key name, then its status badge, its prefix, and its expiry labelled (a bare date could be any of the key\\'s dates).',\n sections: {\n overview: {\n purpose: 'Key prefix, description and roles: what the key is and what it may do.',\n whenToUse: 'The first block of a single key\\'s read page.',\n textSlots: {\n title: { purpose: 'Name the key-identity block. Not rendered on the read page, where the header already names the key.' },\n },\n },\n lifecycle: {\n purpose: 'Expiry, last use and creation; and, while a rotated key\\'s previous secret still authenticates, that secret\\'s prefix and when it stops (after a regenerate it has no end date and keeps working until the next rotation, which the prefix row\\'s description says).',\n whenToUse: 'Judging whether a key is still live, and when it was last used.',\n textSlots: {\n title: { purpose: 'Label the validity and usage block.' },\n },\n },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Primary navigation within app admin when keys are a tab/section; non-addressable in the preset’s view wiring but still the inventory surface for operators.', whenToUse: 'App super-admin app detail → API keys tab.' },\n [Op.READ]: { purpose: 'Read shell for a single app key; non-addressable in default preset list.', whenToUse: 'Drill-in from the key list in app admin UIs when routes expose READ.' },\n [Op.CREATE]: { purpose: 'Create a new app key; plaintext appears only in the create response on success per factory DTOs.', whenToUse: 'First-time integration and additional automation credentials.' },\n [Op.SEARCH]: { purpose: 'Admin search with filter fields defined in the factory for app keys.', whenToUse: 'Finding a key in apps with many credentials.' },\n [AppApiKeys_Operations.ROTATE]: { purpose: 'Rotation workflow; not addressable in default preset `views` array.', whenToUse: 'Security and incident rotation from a key detail or action surface when wired.' },\n [AppApiKeys_Operations.REGENERATE]: { purpose: 'Lighter reissue of secret material; non-addressable in default preset `views` array.', whenToUse: 'When overlap between old and new is acceptable; email notifications may fire.' },\n [AppApiKeys_Operations.DEACTIVATE]: { purpose: 'Disable an active key in place; status-gated in the factory enablement check.', whenToUse: 'Stop traffic for a compromised or obsolete integration key.' },\n [AppApiKeys_Operations.REACTIVATE]: { purpose: 'Undo deactivation for policy-approved reuse.', whenToUse: 'When a key was turned off temporarily rather than deleted.' },\n [AppApiKeys_Operations.EXTEND_EXPIRY]: { purpose: 'Push expiry for keys that have an expiration set.', whenToUse: 'Before automated expiry to avoid service outage.' },\n [AppApiKeys_Operations.USAGE_STATS]: { purpose: 'Usage analytics view for a key; not addressable in default preset `views` array.', whenToUse: 'Admin troubleshooting and SLO review.' },\n },\n }),\n);\n"]}
|
package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"application-metadata.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-metadata.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,qBAAqB,IAAI,EAAE,EAG5B,MAAM,uBAAuB,CAAC;AAe/B,eAAO,MAAM,wCAAwC;;;;
|
|
1
|
+
{"version":3,"file":"application-metadata.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-metadata.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,qBAAqB,IAAI,EAAE,EAG5B,MAAM,uBAAuB,CAAC;AAe/B,eAAO,MAAM,wCAAwC;;;;iCAmJpD,CAAC"}
|
package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js
CHANGED
|
@@ -72,7 +72,7 @@ export const applicationMetadataResourceSpecification = resourceSpecificationFro
|
|
|
72
72
|
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The metadata child was created for the parent application and the stored description is returned.' },
|
|
73
73
|
],
|
|
74
74
|
errorScenarios: [
|
|
75
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The description payload fails schema validation.'
|
|
75
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The description payload fails schema validation.' },
|
|
76
76
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata authoring is org-admin gated.' },
|
|
77
77
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The parent application this metadata attaches to does not exist in the caller’s scope.' },
|
|
78
78
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The application already has a metadata record — the `APPLICATION → APPLICATION_METADATA` relationship is one-to-one, so a second create collides.' },
|
|
@@ -109,7 +109,7 @@ export const applicationMetadataResourceSpecification = resourceSpecificationFro
|
|
|
109
109
|
{ code: HttpResponseStatusCode.OK_200, meaning: 'The metadata description was updated and the new value is returned.' },
|
|
110
110
|
],
|
|
111
111
|
errorScenarios: [
|
|
112
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited description fails schema validation.'
|
|
112
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited description fails schema validation.' },
|
|
113
113
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata edits are org-admin gated.' },
|
|
114
114
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application in the caller’s scope.' },
|
|
115
115
|
],
|
|
@@ -132,6 +132,10 @@ export const applicationMetadataResourceSpecification = resourceSpecificationFro
|
|
|
132
132
|
'The merged `application` admin preset exposes `APPLICATION_METADATA` as a tab; main preset hides the relationship — only admin UI behavior is exported for the spec to validate.',
|
|
133
133
|
],
|
|
134
134
|
}), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION }), () => ({
|
|
135
|
+
layout: {
|
|
136
|
+
purpose: 'One field, so no sections: the application\'s description, offered in place on the Settings → Administration → General pane.',
|
|
137
|
+
displayPurpose: 'A single settings row for the description, editable in place; an empty description says so rather than showing a dash, because the seed writes an empty one and this pane is where somebody fills it in. The form is the description alone, as a paragraph.',
|
|
138
|
+
},
|
|
135
139
|
views: {
|
|
136
140
|
[Op.CREATE]: { purpose: 'Create metadata in admin tab host after the app exists.', whenToUse: 'First-time setup of marketing copy in platform tools.' },
|
|
137
141
|
[Op.READ]: { purpose: 'Read-only about body for admins editing context.', whenToUse: 'Support reviewing app narrative before a launch.' },
|
package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"application-metadata.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-metadata.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { applicationMetadataAdminResourceUIBehavior as applicationMetadataSource } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ApplicationMetadataSchema,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n applicationMetadataResourceConfiguration_InitializationFactory as applicationMetadataFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof applicationMetadataFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\n\nconst applicationMetadataUI = applicationMetadataSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nexport const applicationMetadataResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n resourceFrontendConfiguration(applicationMetadataUI),\n resourceSpecification(\n applicationMetadataFactory,\n ApplicationMetadataSchema,\n ({ schemaShape }) => ({\n purpose: 'The descriptive text about the application itself: what it is for, who it serves and how it is positioned, kept separately from the application\\'s identity record.',\n businessRole: 'Feeds about pages, app-store-like listings, and support tooling with narrative context.',\n lifecycleRole: 'Co-updated with branding and GTM; long-form `description` can change more often than slugs.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.APPLICATIONS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApplicationMetadataSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'applicationMetadataResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'APPLICATION_METADATA',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'applicationMetadataAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n },\n fields: {\n applicationId: schemaShape.applicationId.foreignKeySpec({\n meaning: 'The owning `applications` record this metadata describes; immutable after create (one metadata record per application).',\n whyItMatters: 'Anchors the narrative to a single application so about-pages and support tooling render the right description; the `APPLICATION → APPLICATION_METADATA` relationship is one-to-one.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n description: schemaShape.description.stringSpec({\n meaning: 'Indexed description for search and about-page rendering.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n operations: {\n [Op.CREATE]: {\n purpose:\n 'Author metadata for an `APPLICATION` row that has none. In practice the row normally exists already: '\n + 'the framework seeds it at application init (`engine-applications:application-metadata`, ADDITIVE) with the '\n + 'schema-default empty description, because the APPLICATION row itself is provisioned by the apps-manager at '\n + 'the repository tier and so triggers no composition lifecycle. Authoring a real description is therefore an '\n + 'UPDATE on the seeded row; this CREATE remains for an application whose seed never ran.',\n outcome: 'Downstream UIs and SEO surfaces have a paragraph of truth.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The metadata child was created for the parent application and the stored description is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The description payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata authoring is org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The parent application this metadata attaches to does not exist in the caller’s scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The application already has a metadata record — the `APPLICATION → APPLICATION_METADATA` relationship is one-to-one, so a second create collides.' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Seed metadata for an application',\n request: {\n description: 'Wonder Todos keeps small teams aligned with shared, prioritized task lists.',\n },\n response: {\n description: 'Wonder Todos keeps small teams aligned with shared, prioritized task lists.',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.READ]: {\n purpose: 'Public or member read of description for about surfaces.',\n outcome: 'Consistent long-form text across hosts.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The application metadata was found and its description is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application in the caller’s scope.' },\n ],\n idempotent: true,\n },\n [Op.UPDATE]: {\n purpose: 'Org or platform admin edits the narrative and SEO fields.',\n outcome: 'Search indexes and in-app about pages refresh on next load.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata description was updated and the new value is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited description fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata edits are org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application in the caller’s scope.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Remove the metadata child when the app record is decommissioned.',\n outcome: 'Description no longer published; `APPLICATION` removal rules apply separately.',\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The metadata child was deleted; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata deletion is org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application (or it was already deleted).' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'The merged `application` admin preset exposes `APPLICATION_METADATA` as a tab; main preset hides the relationship — only admin UI behavior is exported for the spec to validate.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n ),\n () => ({\n views: {\n [Op.CREATE]: { purpose: 'Create metadata in admin tab host after the app exists.', whenToUse: 'First-time setup of marketing copy in platform tools.' },\n [Op.READ]: { purpose: 'Read-only about body for admins editing context.', whenToUse: 'Support reviewing app narrative before a launch.' },\n [Op.UPDATE]: { purpose: 'Inline long-form description editor from admin preset form.', whenToUse: 'Launch-week copy iterations and rebrand work.' },\n [Op.DELETE]: { purpose: 'Remove the metadata sub-document when the app is torn down.', whenToUse: 'GDPR, mistaken provisioning, and migration to another metadata store.' },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"application-metadata.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-metadata.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { applicationMetadataAdminResourceUIBehavior as applicationMetadataSource } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ApplicationMetadataSchema,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n applicationMetadataResourceConfiguration_InitializationFactory as applicationMetadataFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof applicationMetadataFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\n\nconst applicationMetadataUI = applicationMetadataSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nexport const applicationMetadataResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n resourceFrontendConfiguration(applicationMetadataUI),\n resourceSpecification(\n applicationMetadataFactory,\n ApplicationMetadataSchema,\n ({ schemaShape }) => ({\n purpose: 'The descriptive text about the application itself: what it is for, who it serves and how it is positioned, kept separately from the application\\'s identity record.',\n businessRole: 'Feeds about pages, app-store-like listings, and support tooling with narrative context.',\n lifecycleRole: 'Co-updated with branding and GTM; long-form `description` can change more often than slugs.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.APPLICATIONS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ApplicationMetadataSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'applicationMetadataResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'APPLICATION_METADATA',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'applicationMetadataAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n },\n fields: {\n applicationId: schemaShape.applicationId.foreignKeySpec({\n meaning: 'The owning `applications` record this metadata describes; immutable after create (one metadata record per application).',\n whyItMatters: 'Anchors the narrative to a single application so about-pages and support tooling render the right description; the `APPLICATION → APPLICATION_METADATA` relationship is one-to-one.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n description: schemaShape.description.stringSpec({\n meaning: 'Indexed description for search and about-page rendering.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n operations: {\n [Op.CREATE]: {\n purpose:\n 'Author metadata for an `APPLICATION` row that has none. In practice the row normally exists already: '\n + 'the framework seeds it at application init (`engine-applications:application-metadata`, ADDITIVE) with the '\n + 'schema-default empty description, because the APPLICATION row itself is provisioned by the apps-manager at '\n + 'the repository tier and so triggers no composition lifecycle. Authoring a real description is therefore an '\n + 'UPDATE on the seeded row; this CREATE remains for an application whose seed never ran.',\n outcome: 'Downstream UIs and SEO surfaces have a paragraph of truth.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The metadata child was created for the parent application and the stored description is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The description payload fails schema validation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata authoring is org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The parent application this metadata attaches to does not exist in the caller’s scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The application already has a metadata record — the `APPLICATION → APPLICATION_METADATA` relationship is one-to-one, so a second create collides.' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Seed metadata for an application',\n request: {\n description: 'Wonder Todos keeps small teams aligned with shared, prioritized task lists.',\n },\n response: {\n description: 'Wonder Todos keeps small teams aligned with shared, prioritized task lists.',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.READ]: {\n purpose: 'Public or member read of description for about surfaces.',\n outcome: 'Consistent long-form text across hosts.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The application metadata was found and its description is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application in the caller’s scope.' },\n ],\n idempotent: true,\n },\n [Op.UPDATE]: {\n purpose: 'Org or platform admin edits the narrative and SEO fields.',\n outcome: 'Search indexes and in-app about pages refresh on next load.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata description was updated and the new value is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited description fails schema validation.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata edits are org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application in the caller’s scope.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Remove the metadata child when the app record is decommissioned.',\n outcome: 'Description no longer published; `APPLICATION` removal rules apply separately.',\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The metadata child was deleted; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an org admin for the owning application; metadata deletion is org-admin gated.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No metadata record exists for the addressed application (or it was already deleted).' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'The merged `application` admin preset exposes `APPLICATION_METADATA` as a tab; main preset hides the relationship — only admin UI behavior is exported for the spec to validate.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n ),\n () => ({\n layout: {\n purpose: 'One field, so no sections: the application\\'s description, offered in place on the Settings → Administration → General pane.',\n displayPurpose: 'A single settings row for the description, editable in place; an empty description says so rather than showing a dash, because the seed writes an empty one and this pane is where somebody fills it in. The form is the description alone, as a paragraph.',\n },\n views: {\n [Op.CREATE]: { purpose: 'Create metadata in admin tab host after the app exists.', whenToUse: 'First-time setup of marketing copy in platform tools.' },\n [Op.READ]: { purpose: 'Read-only about body for admins editing context.', whenToUse: 'Support reviewing app narrative before a launch.' },\n [Op.UPDATE]: { purpose: 'Inline long-form description editor from admin preset form.', whenToUse: 'Launch-week copy iterations and rebrand work.' },\n [Op.DELETE]: { purpose: 'Remove the metadata sub-document when the app is torn down.', whenToUse: 'GDPR, mistaken provisioning, and migration to another metadata store.' },\n },\n }),\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"application-oauth-clients.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-oauth-clients.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,qBAAqB,IAAI,EAAE,EAC3B,cAAc,EAEd,6BAA6B,EAC7B,iBAAiB,EACjB,4BAA4B,
|
|
1
|
+
{"version":3,"file":"application-oauth-clients.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/applications/resources/application-oauth-clients.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,cAAc,EACd,qBAAqB,IAAI,EAAE,EAC3B,cAAc,EAEd,6BAA6B,EAC7B,iBAAiB,EACjB,4BAA4B,EAI7B,MAAM,uBAAuB,CAAC;AA8E/B,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;iCA+fxD,CAAC"}
|
package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { appOAuthClientsApplicationAdminResourceUIBehavior as appOAuthClientsUIBehaviorSource } from '@wildo-ai/presets-components';
|
|
2
2
|
import { LabelAudience } from '@wildo-ai/presets-components-models';
|
|
3
3
|
import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
|
|
4
|
-
import { AppOAuthClients_Operations, ApiKeyScope, CORE_APP_ROLES, CoreResourceOperation as Op, OAuthGrantType, OAuthClientApplicationSchema, OAuthClientRegistrationOrigin, OAuthClientStatus, OAuthTokenEndpointAuthMethod, ResourcePrimaryScope, appOAuthClientsResourceConfiguration_InitializationFactory as appOAuthClientsFactory, } from '@wildo-ai/saas-models';
|
|
4
|
+
import { AppOAuthClients_Operations, ApiKeyScope, CORE_APP_ROLES, CoreResourceOperation as Op, OAuthGrantType, OAuthClientApplicationSchema, OAuthClientRegistrationOrigin, OAuthClientStatus, OAuthTokenEndpointAuthMethod, ResourcePrimaryScope, appOAuthClientsResourceConfiguration_InitializationFactory as appOAuthClientsFactory, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
|
|
5
5
|
import { HttpResponseStatusCode, resourceFrontendConfiguration, resourceSpecification, resourceSpecificationFromFrontendConfiguration } from '../../../_core/index.js';
|
|
6
6
|
import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
|
|
7
7
|
const APPLICATION_OAUTH_CLIENT_RECORD_EXAMPLE = {
|
|
@@ -47,7 +47,7 @@ const appOAuthClientsUIBehavior = appOAuthClientsUIBehaviorSource;
|
|
|
47
47
|
export const applicationOAuthClientsResourceSpecification = resourceSpecificationFromFrontendConfiguration(resourceFrontendConfiguration(appOAuthClientsUIBehavior), resourceSpecification(appOAuthClientsFactory, OAuthClientApplicationSchema, ({ schemaShape }) => ({
|
|
48
48
|
purpose: 'Application-scoped registered OAuth clients: client-credentials secrets for obtaining tokens and calling backend APIs in app-level automation and integration contexts.',
|
|
49
49
|
businessRole: 'App-admin machine-to-machine OAuth credential. Under client-credentials it authenticates the SAME application machine principal (`APPLICATION_MACHINE`) that an application API key does — a distinct credential type, not a distinct principal — distinct from end-user sessions and from organization OAuth clients.',
|
|
50
|
-
lifecycleRole: 'Created, rotated, regenerated, and retired by application administrators; ordinary application members cannot manage these credentials.
|
|
50
|
+
lifecycleRole: 'Created, rotated, regenerated, and retired by application administrators; ordinary application members cannot manage these credentials. `lastUsedAt` records when the client was last accepted, which is the signal for finding stale or leaked clients.',
|
|
51
51
|
audience: LabelAudience.DEVELOPER,
|
|
52
52
|
subDomain: EngineResourceSubDomain.APPLICATIONS,
|
|
53
53
|
codeHandling: {
|
|
@@ -87,7 +87,7 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
87
87
|
},
|
|
88
88
|
},
|
|
89
89
|
notes: [
|
|
90
|
-
'
|
|
90
|
+
'Frontend narration comes from the `appOAuthClientsApplicationAdminResourceUIBehavior` preset (Settings → Administration → OAuth clients), overlaid below.',
|
|
91
91
|
'Runtime declares userNotifications with channel EMAIL on CREATE/ROTATE/REGENERATE/DEACTIVATE/REACTIVATE; DF-1 communications blocks are omitted from this pass to stay a structural mirror of the api-keys spec, which likewise documents no communications blocks.',
|
|
92
92
|
],
|
|
93
93
|
},
|
|
@@ -156,7 +156,7 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
156
156
|
applicationId: schemaShape.applicationId.stringSpec({ meaning: 'Immutable owning application for this client record.' }),
|
|
157
157
|
expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Optional hard stop for validity.' }),
|
|
158
158
|
lastUsedAt: schemaShape.lastUsedAt.dateSpec({
|
|
159
|
-
meaning: '
|
|
159
|
+
meaning: 'When the client was last accepted, to the minute: at the token endpoint (any grant), with its secret presented directly on a request, or through one of its access tokens. Written at most once a minute and without moving `updatedAt`. Absent means it has never been accepted since it was created.',
|
|
160
160
|
}),
|
|
161
161
|
previousSecretPrefix: schemaShape.previousSecretPrefix.stringSpec({
|
|
162
162
|
meaning: 'Public prefix of the previous secret retained during a rotation or regeneration overlap window.',
|
|
@@ -164,6 +164,9 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
164
164
|
previousSecretInvalidationDate: schemaShape.previousSecretInvalidationDate.dateSpec({
|
|
165
165
|
meaning: 'After a rotation, when the PRIOR secret stops authenticating; during this grace window both secrets work so integrations can migrate without downtime (absent/null after a regenerate = prior secret valid until the next rotation).',
|
|
166
166
|
}),
|
|
167
|
+
registrationAccessTokenPrefix: schemaShape.registrationAccessTokenPrefix.stringSpec({
|
|
168
|
+
meaning: 'The first 8 characters of the registration access token a dynamically registered client uses to manage its own registration, so the token can be identified without revealing it. Absent on every client that was not registered dynamically.',
|
|
169
|
+
}),
|
|
167
170
|
redirectUris: schemaShape.redirectUris.arraySpec({
|
|
168
171
|
meaning: 'Exact-match allowlist of post-authorization redirect targets for the authorization_code flow. A request redirect_uri must equal one entry by exact string (no wildcards/substrings), and each entry is itself constrained to a safe absolute URL — https for any host/port, or http only for a loopback host — with no fragment or embedded credentials, so a registered entry can never become an open-redirect or stored-XSS navigation target. Empty for pure client_credentials clients.',
|
|
169
172
|
elementMeaning: 'One registered redirect URI: an https URL (any host/port) or an http loopback URL (localhost / 127.0.0.1 / ::1).',
|
|
@@ -315,7 +318,7 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
315
318
|
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The client was registered; the response carries the one-time plaintext secret alongside the persisted metadata.' },
|
|
316
319
|
],
|
|
317
320
|
errorScenarios: [
|
|
318
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The client name, roles, or expiry payload fails schema validation.'
|
|
321
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The client name, roles, or expiry payload fails schema validation.' },
|
|
319
322
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; registering clients is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },
|
|
320
323
|
],
|
|
321
324
|
idempotent: false,
|
|
@@ -424,9 +427,9 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
424
427
|
{ code: HttpResponseStatusCode.OK_200, meaning: 'The client was rotated; the response carries the new one-time plaintext and the old-material cutover fields.' },
|
|
425
428
|
],
|
|
426
429
|
errorScenarios: [
|
|
427
|
-
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.'
|
|
430
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The rotation boundary/cutover payload fails schema validation.' },
|
|
428
431
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an app super-admin; rotation is a high-risk `APP_ADMIN_SUPER_ADMIN`-only operation.' },
|
|
429
|
-
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous secret becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.',
|
|
432
|
+
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Rotation hands back the replacement in plaintext and establishes when the previous secret becomes unusable, so holding a live session is deliberately not sufficient — obtain a token from the re-authentication route and retry with it.', customMessageReference: ErrorCustomMessageReference.STEP_UP_REQUIRED },
|
|
430
433
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No app client exists for the supplied id in the caller’s application scope.' },
|
|
431
434
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The client is in a state where rotation is not allowed (e.g. it is already inactive or expired).' },
|
|
432
435
|
],
|
|
@@ -491,14 +494,14 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
491
494
|
},
|
|
492
495
|
layout: {
|
|
493
496
|
purpose: 'Four sections: `overview` (which client this is and whether it is usable), `access` (what it may ask for), `redirects` (where the authorization-code leg may return), `lifecycle` (validity and last use). Deliberately one more than the api-keys sibling — redirect URIs exist only for the interactive leg and are the one field whose exact value decides whether a sign-in round trip lands, so burying them inside `access` would hide the thing most often mistyped.',
|
|
494
|
-
displayPurpose: 'Read and edit share the section vocabulary; the edit layout omits `overview.status` and the whole `lifecycle` block because status moves through DEACTIVATE / REACTIVATE / EXPIRE and never through a form.',
|
|
497
|
+
displayPurpose: 'The header carries the client name and its status badge, so neither is a row. `overview` is an untitled card of the secret prefix and the description (hidden when empty); `access`, `redirects` and `lifecycle` are titled cards, and no read section shows a description. Empty rows that say nothing hide: the post-logout redirects, the expiry, the last use. Read and edit share the section vocabulary; the edit layout omits `overview.status` and the whole `lifecycle` block because status moves through DEACTIVATE / REACTIVATE / EXPIRE and never through a form. The form focuses the name and keeps one description, on `redirects`.',
|
|
498
|
+
summaryPurpose: 'A card titled with the client name, then its status badge, its secret prefix, and its expiry labelled (a bare date could be any of the client\'s dates).',
|
|
495
499
|
sections: {
|
|
496
500
|
overview: {
|
|
497
501
|
purpose: 'Name, description, status and the non-secret `secretPrefix` that identifies WHICH credential a log line names.',
|
|
498
502
|
whenToUse: 'Recognising a client in a list, and confirming it is the one an incident refers to.',
|
|
499
503
|
textSlots: {
|
|
500
|
-
title: { purpose: 'Name the client
|
|
501
|
-
description: { purpose: 'State that the full secret is shown only at create, rotate and regenerate, and is never retrievable afterwards.' },
|
|
504
|
+
title: { purpose: 'Name the client-identity block. Not rendered: the page header already names the client.' },
|
|
502
505
|
},
|
|
503
506
|
},
|
|
504
507
|
access: {
|
|
@@ -506,7 +509,6 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
506
509
|
whenToUse: 'Deciding what this credential can actually do before approving or narrowing it.',
|
|
507
510
|
textSlots: {
|
|
508
511
|
title: { purpose: 'Label the authority block.' },
|
|
509
|
-
description: { purpose: 'Make clear these bound what the client may ASK for; the token service still decides what it receives.' },
|
|
510
512
|
},
|
|
511
513
|
},
|
|
512
514
|
redirects: {
|
|
@@ -522,7 +524,6 @@ export const applicationOAuthClientsResourceSpecification = resourceSpecificatio
|
|
|
522
524
|
whenToUse: 'Judging whether a client is still in service before retiring it.',
|
|
523
525
|
textSlots: {
|
|
524
526
|
title: { purpose: 'Label the validity block.' },
|
|
525
|
-
description: { purpose: 'Note that `lastUsedAt` is not populated by the current token paths, so an empty value is not evidence of disuse.' },
|
|
526
527
|
},
|
|
527
528
|
},
|
|
528
529
|
},
|