@meshery/schemas 1.3.102 → 1.3.103
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/cloudApi.d.mts +4496 -4098
- package/dist/cloudApi.d.ts +4496 -4098
- package/dist/cloudApi.js +1 -1
- package/dist/cloudApi.mjs +1 -1
- package/dist/constructs/v1alpha1/core/Core.d.ts +1 -1
- package/dist/constructs/v1alpha1/core/CoreSchema.js +1 -1
- package/dist/constructs/v1alpha1/core/CoreSchema.mjs +1 -1
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.d.ts +536 -0
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.js +1 -0
- package/dist/constructs/v1beta1/diagnostics/Diagnostics.mjs +0 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.d.ts +2 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.js +2 -0
- package/dist/constructs/v1beta1/diagnostics/DiagnosticsSchema.mjs +2 -0
- package/dist/constructs/v1beta1/support/Support.d.ts +373 -0
- package/dist/constructs/v1beta1/support/SupportSchema.js +1 -1
- package/dist/constructs/v1beta1/support/SupportSchema.mjs +1 -1
- package/dist/constructs/v1beta2/core/Core.d.ts +26 -1
- package/dist/constructs/v1beta2/core/CoreSchema.js +1 -1
- package/dist/constructs/v1beta2/core/CoreSchema.mjs +1 -1
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealth.d.ts +50 -0
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealthSchema.js +1 -1
- package/dist/constructs/v1beta3/blowhorn_health/BlowhornHealthSchema.mjs +1 -1
- package/dist/constructs/v1beta3/claim/Claim.d.ts +150 -0
- package/dist/constructs/v1beta3/claim/ClaimSchema.js +2 -2
- package/dist/constructs/v1beta3/claim/ClaimSchema.mjs +2 -2
- package/dist/constructs/v1beta3/connection/Connection.d.ts +100 -0
- package/dist/constructs/v1beta3/connection/ConnectionSchema.js +3 -3
- package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +3 -3
- package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +150 -0
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +5 -5
- package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +5 -5
- package/dist/constructs/v1beta3/design/DesignSchema.js +5 -5
- package/dist/constructs/v1beta3/design/DesignSchema.mjs +5 -5
- package/dist/constructs/v1beta3/event/Event.d.ts +275 -0
- package/dist/constructs/v1beta3/event/EventSchema.js +3 -3
- package/dist/constructs/v1beta3/event/EventSchema.mjs +3 -3
- package/dist/constructs/v1beta3/github/GithubSchema.js +1 -1
- package/dist/constructs/v1beta3/github/GithubSchema.mjs +1 -1
- package/dist/constructs/v1beta3/invitation/InvitationSchema.js +1 -1
- package/dist/constructs/v1beta3/invitation/InvitationSchema.mjs +1 -1
- package/dist/constructs/v1beta3/ledger/Ledger.d.ts +175 -0
- package/dist/constructs/v1beta3/ledger/LedgerSchema.js +5 -5
- package/dist/constructs/v1beta3/ledger/LedgerSchema.mjs +5 -5
- package/dist/constructs/v1beta3/profile/Profile.d.ts +225 -0
- package/dist/constructs/v1beta3/profile/ProfileSchema.js +1 -1
- package/dist/constructs/v1beta3/profile/ProfileSchema.mjs +1 -1
- package/dist/constructs/v1beta3/provider_capability/ProviderCapability.d.ts +50 -0
- package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.js +1 -1
- package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.mjs +1 -1
- package/dist/constructs/v1beta3/schedule/Schedule.d.ts +225 -0
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +8 -8
- package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +8 -8
- package/dist/index.d.mts +1 -1
- package/dist/index.d.ts +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var e={openapi:"3.0.0",info:{title:"Diagnostics",description:"OpenAPI schema for anonymous, redacted failure diagnostics submitted by desktop clients.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},tags:[{name:"Diagnostics",description:"Operations related to failure diagnostics"}],paths:{"/api/diagnostics/failures":{post:{"x-internal":["cloud"],tags:["Diagnostics"],summary:"Submit a failure diagnostic",description:"Accepts a small, anonymous, redacted diagnostic of a client-side failure, so maintainers learn about it before anyone writes in. Authentication is a per-client-kind, per-release-channel pre-shared key in the X-Client-Key header (a speed bump plus a revocation handle, not a strong secret: the key ships in the app and can be extracted). A signed-in caller may use its bearer token instead; then the organization is attached, and only then. The server enforces a body cap, strict decoding (unknown fields are rejected), rate limits, server-side re-redaction, and a 90-day retention on stored rows. Served by Layer5 Cloud (meshery-cloud #6330); see Blowhorn issue #771.",operationId:"submitFailureDiagnostic",security:[{clientKey:[]},{jwt:[]}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"A single anonymous, redacted report of a client-side failure. The same failure is deduplicated per install per day: one report carries the first time it was seen and how many times it has occurred since. Nothing in this report identifies a person: no config files, logs, account names, post text, or tokens, and the failure message keeps only the redacted cause sentence. Every object in this schema is closed (additionalProperties: false), so a client sending an unknown field gets a 400 rather than a silently widened report.",additionalProperties:false,required:["diagnosticId","occurredAt","firstSeenAt","count","client","os","failure","compat"],properties:{diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Id generated by the client for this report. A human support request links back to it through AnonymousSupportRequest.diagnosticId."},occurredAt:{type:"string",title:"Occurred At",format:"date-time",description:"When this occurrence of the failure happened."},firstSeenAt:{type:"string",title:"First Seen At",format:"date-time",description:"When this failure was first seen on this install, for the deduplication window the count covers."},count:{type:"integer",title:"Count",minimum:1,description:"How many times the same failure has occurred on this install within the deduplication window (per install per day)."},client:{type:"object",title:"Client",additionalProperties:false,required:["kind","version","buildSha","channel"],properties:{kind:{type:"string",title:"Kind",enum:["blowhorn-desktop"],description:"The client that produced this report."},version:{type:"string",title:"Version",minLength:1,maxLength:64,description:"Client version, for example the app release version."},buildSha:{type:"string",title:"Build SHA",minLength:1,maxLength:128,description:"Source revision the client build came from."},channel:{type:"string",title:"Channel",minLength:1,maxLength:64,description:"Release channel the client build belongs to. Kept a free string rather than an enum: channel names are release-process values, and a new channel must not make older clients' reports undecodable."}}},os:{type:"object",title:"Operating System",additionalProperties:false,required:["name","version","arch"],properties:{name:{type:"string",title:"Name",minLength:1,maxLength:128,description:"Operating system name."},version:{type:"string",title:"Version",minLength:1,maxLength:128,description:"Operating system version."},arch:{type:"string",title:"Architecture",minLength:1,maxLength:64,description:"Operating system architecture."}}},failure:{type:"object",title:"Failure",additionalProperties:false,required:["surface","cause","code","message","ticksSkipped"],properties:{surface:{type:"string",title:"Surface",enum:["tray","popover","console","service"],description:"Where the failure first became visible to the person."},cause:{type:"string",title:"Cause",pattern:"^[a-z][a-z0-9_]*$",maxLength:64,description:"Stable machine-readable name for the cause. Deliberately a patterned string, not a closed enum: new failure causes are named by the client over time, and a closed enum would make the server reject reports carrying a cause it does not know yet. Consumers must treat an unknown cause as opaque, never as an error. Known causes today are the Blowhorn engine's StoreUnavailable.cause names: unavailable, not_configured, incomplete, bad_setting, config_unreadable, tunnel_refused, tunnel_silent, tunnel_off, not_postgres, auth_rejected, host_not_permitted, database_missing, timeout, version_unreadable, ledger_unreadable, schema_behind, schema_ahead, schema_edited, no_organization, unknown_organization, plus other named causes as clients add them."},code:{type:"string",title:"Code",maxLength:128,description:"Machine-readable code for the failure, when the failure carries one beyond its cause (for example an exit or provider code). Kept a string so numeric and symbolic codes both fit; empty when the failure carries no code."},message:{type:"string",title:"Message",maxLength:500,description:"Redacted human-readable sentence for the failure: only the cause sentence survives, with paths, usernames, emails, profile names, post text, and tokens removed."},ticksSkipped:{type:"integer",title:"Ticks Skipped",minimum:0,description:"How many scheduled ticks the failure skipped, when the failure interrupted scheduled work."}}},compat:{type:"object",title:"Compatibility",additionalProperties:false,required:["requiresSchema","contractVersion"],properties:{requiresSchema:{type:"string",title:"Requires Schema",minLength:1,maxLength:128,description:"Schema version the client requires the server to speak for this report to be understood."},contractVersion:{type:"string",title:"Contract Version",minLength:1,maxLength:64,description:"Version of the client-server contract this report was built against. Kept a string so dotted versions and plain numbers both fit."}}},installId:{type:"string",title:"Install ID",format:"uuid",maxLength:128,description:"Optional per-install id, present only when the person has not opted out of failure reports. A random uuid4 minted once per install (Blowhorn's installationId, written beside cloud.yaml and reused), never a hardware id. Omitted entirely when opted out."}}}}}},responses:{201:{description:"Failure diagnostic stored",content:{"application/json":{schema:{type:"object",additionalProperties:false,required:["diagnosticId"],properties:{diagnosticId:{type:"string",format:"uuid",description:"The stored diagnostic's id: the client's own when it sent one, otherwise generated by the server. Send it as AnonymousSupportRequest.diagnosticId to link a human report to this diagnostic."}}}}}},400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},401:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},413:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},429:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},503:{description:"The diagnostics store is not configured on this server; retry later.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}}}}},components:{responses:{MeshkitError400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},MeshkitError500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},ClientKeyUnauthorized:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},PayloadTooLarge:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},RateLimited:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}},securitySchemes:{clientKey:{type:"apiKey",in:"header",name:"X-Client-Key",description:"Per-client-kind, per-release-channel pre-shared key, of the form `<key id>.<secret>`. At least two keys are valid at any time so rotation never breaks old builds."},jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{FailureDiagnostic:{type:"object",description:"A single anonymous, redacted report of a client-side failure. The same failure is deduplicated per install per day: one report carries the first time it was seen and how many times it has occurred since. Nothing in this report identifies a person: no config files, logs, account names, post text, or tokens, and the failure message keeps only the redacted cause sentence. Every object in this schema is closed (additionalProperties: false), so a client sending an unknown field gets a 400 rather than a silently widened report.",additionalProperties:false,required:["diagnosticId","occurredAt","firstSeenAt","count","client","os","failure","compat"],properties:{diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Id generated by the client for this report. A human support request links back to it through AnonymousSupportRequest.diagnosticId."},occurredAt:{type:"string",title:"Occurred At",format:"date-time",description:"When this occurrence of the failure happened."},firstSeenAt:{type:"string",title:"First Seen At",format:"date-time",description:"When this failure was first seen on this install, for the deduplication window the count covers."},count:{type:"integer",title:"Count",minimum:1,description:"How many times the same failure has occurred on this install within the deduplication window (per install per day)."},client:{type:"object",title:"Client",additionalProperties:false,required:["kind","version","buildSha","channel"],properties:{kind:{type:"string",title:"Kind",enum:["blowhorn-desktop"],description:"The client that produced this report."},version:{type:"string",title:"Version",minLength:1,maxLength:64,description:"Client version, for example the app release version."},buildSha:{type:"string",title:"Build SHA",minLength:1,maxLength:128,description:"Source revision the client build came from."},channel:{type:"string",title:"Channel",minLength:1,maxLength:64,description:"Release channel the client build belongs to. Kept a free string rather than an enum: channel names are release-process values, and a new channel must not make older clients' reports undecodable."}}},os:{type:"object",title:"Operating System",additionalProperties:false,required:["name","version","arch"],properties:{name:{type:"string",title:"Name",minLength:1,maxLength:128,description:"Operating system name."},version:{type:"string",title:"Version",minLength:1,maxLength:128,description:"Operating system version."},arch:{type:"string",title:"Architecture",minLength:1,maxLength:64,description:"Operating system architecture."}}},failure:{type:"object",title:"Failure",additionalProperties:false,required:["surface","cause","code","message","ticksSkipped"],properties:{surface:{type:"string",title:"Surface",enum:["tray","popover","console","service"],description:"Where the failure first became visible to the person."},cause:{type:"string",title:"Cause",pattern:"^[a-z][a-z0-9_]*$",maxLength:64,description:"Stable machine-readable name for the cause. Deliberately a patterned string, not a closed enum: new failure causes are named by the client over time, and a closed enum would make the server reject reports carrying a cause it does not know yet. Consumers must treat an unknown cause as opaque, never as an error. Known causes today are the Blowhorn engine's StoreUnavailable.cause names: unavailable, not_configured, incomplete, bad_setting, config_unreadable, tunnel_refused, tunnel_silent, tunnel_off, not_postgres, auth_rejected, host_not_permitted, database_missing, timeout, version_unreadable, ledger_unreadable, schema_behind, schema_ahead, schema_edited, no_organization, unknown_organization, plus other named causes as clients add them."},code:{type:"string",title:"Code",maxLength:128,description:"Machine-readable code for the failure, when the failure carries one beyond its cause (for example an exit or provider code). Kept a string so numeric and symbolic codes both fit; empty when the failure carries no code."},message:{type:"string",title:"Message",maxLength:500,description:"Redacted human-readable sentence for the failure: only the cause sentence survives, with paths, usernames, emails, profile names, post text, and tokens removed."},ticksSkipped:{type:"integer",title:"Ticks Skipped",minimum:0,description:"How many scheduled ticks the failure skipped, when the failure interrupted scheduled work."}}},compat:{type:"object",title:"Compatibility",additionalProperties:false,required:["requiresSchema","contractVersion"],properties:{requiresSchema:{type:"string",title:"Requires Schema",minLength:1,maxLength:128,description:"Schema version the client requires the server to speak for this report to be understood."},contractVersion:{type:"string",title:"Contract Version",minLength:1,maxLength:64,description:"Version of the client-server contract this report was built against. Kept a string so dotted versions and plain numbers both fit."}}},installId:{type:"string",title:"Install ID",format:"uuid",maxLength:128,description:"Optional per-install id, present only when the person has not opted out of failure reports. A random uuid4 minted once per install (Blowhorn's installationId, written beside cloud.yaml and reused), never a hardware id. Omitted entirely when opted out."}}}}}},t=e;
|
|
2
|
+
export{t as default};
|
|
@@ -21,6 +21,26 @@ export interface paths {
|
|
|
21
21
|
patch?: never;
|
|
22
22
|
trace?: never;
|
|
23
23
|
};
|
|
24
|
+
"/api/support/anonymous": {
|
|
25
|
+
parameters: {
|
|
26
|
+
query?: never;
|
|
27
|
+
header?: never;
|
|
28
|
+
path?: never;
|
|
29
|
+
cookie?: never;
|
|
30
|
+
};
|
|
31
|
+
get?: never;
|
|
32
|
+
put?: never;
|
|
33
|
+
/**
|
|
34
|
+
* Submit an anonymous support request
|
|
35
|
+
* @description Accepts a support request without requiring a signed-in user, so a desktop client can offer a "Contact support" action whether or not the person is signed in. A signed-out client authenticates with the same per-client-kind `X-Client-Key` as submitFailureDiagnostic; a signed-in caller may use its bearer token instead, and only then is the organization attached. A request carrying neither is a 401. The email address is only ever sent when the person types it in, and diagnosticId links this report to the automatic failure diagnostic submitted for the same incident, when one exists. Served by Layer5 Cloud; see Blowhorn issue #771.
|
|
36
|
+
*/
|
|
37
|
+
post: operations["submitAnonymousSupportRequest"];
|
|
38
|
+
delete?: never;
|
|
39
|
+
options?: never;
|
|
40
|
+
head?: never;
|
|
41
|
+
patch?: never;
|
|
42
|
+
trace?: never;
|
|
43
|
+
};
|
|
24
44
|
}
|
|
25
45
|
export type webhooks = Record<string, never>;
|
|
26
46
|
export interface components {
|
|
@@ -44,6 +64,37 @@ export interface components {
|
|
|
44
64
|
*/
|
|
45
65
|
scope?: "Support" | "Community" | "Account" | "Commercial";
|
|
46
66
|
};
|
|
67
|
+
/** @description Payload for submitting a help-and-support request without signing in. It carries the same subject, message, and scope as SupportRequest, plus two optional fields: an email address the person typed in for a follow-up, and the diagnosticId of the automatic failure diagnostic for the same incident, when one was submitted. The fields are spelled out here rather than composed with allOf so generated clients expose them flat, exactly like SupportRequest. The object is closed: Cloud decodes it strictly and refuses an unknown field with a 400. */
|
|
68
|
+
AnonymousSupportRequest: {
|
|
69
|
+
/**
|
|
70
|
+
* Subject
|
|
71
|
+
* @description Concise and descriptive title for the support request.
|
|
72
|
+
*/
|
|
73
|
+
subject: string;
|
|
74
|
+
/**
|
|
75
|
+
* Description
|
|
76
|
+
* @description Detailed description of the issue or question.
|
|
77
|
+
*/
|
|
78
|
+
message: string;
|
|
79
|
+
/**
|
|
80
|
+
* Scope
|
|
81
|
+
* @description Category that best represents the nature of the inquiry.
|
|
82
|
+
* @enum {string}
|
|
83
|
+
*/
|
|
84
|
+
scope?: "Support" | "Community" | "Account" | "Commercial";
|
|
85
|
+
/**
|
|
86
|
+
* Email
|
|
87
|
+
* Format: email
|
|
88
|
+
* @description Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client.
|
|
89
|
+
*/
|
|
90
|
+
email?: string;
|
|
91
|
+
/**
|
|
92
|
+
* Diagnostic ID
|
|
93
|
+
* Format: uuid
|
|
94
|
+
* @description Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic.
|
|
95
|
+
*/
|
|
96
|
+
diagnosticId?: string;
|
|
97
|
+
};
|
|
47
98
|
};
|
|
48
99
|
responses: {
|
|
49
100
|
/** @description Expired JWT token used or insufficient privilege */
|
|
@@ -55,6 +106,135 @@ export interface components {
|
|
|
55
106
|
"text/plain": string;
|
|
56
107
|
};
|
|
57
108
|
};
|
|
109
|
+
/** @description Invalid request body or request param */
|
|
110
|
+
MeshkitError400: {
|
|
111
|
+
headers: {
|
|
112
|
+
[name: string]: unknown;
|
|
113
|
+
};
|
|
114
|
+
content: {
|
|
115
|
+
"application/json": {
|
|
116
|
+
/** @description The sentence the caller is shown. */
|
|
117
|
+
error: string;
|
|
118
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
119
|
+
code?: string;
|
|
120
|
+
/**
|
|
121
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
122
|
+
* @enum {string}
|
|
123
|
+
*/
|
|
124
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
125
|
+
/** @description MeshKit's probable causes of the error. */
|
|
126
|
+
probableCause?: string[];
|
|
127
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
128
|
+
suggestedRemediation?: string[];
|
|
129
|
+
};
|
|
130
|
+
};
|
|
131
|
+
};
|
|
132
|
+
/** @description Internal server error */
|
|
133
|
+
MeshkitError500: {
|
|
134
|
+
headers: {
|
|
135
|
+
[name: string]: unknown;
|
|
136
|
+
};
|
|
137
|
+
content: {
|
|
138
|
+
"application/json": {
|
|
139
|
+
/** @description The sentence the caller is shown. */
|
|
140
|
+
error: string;
|
|
141
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
142
|
+
code?: string;
|
|
143
|
+
/**
|
|
144
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
145
|
+
* @enum {string}
|
|
146
|
+
*/
|
|
147
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
148
|
+
/** @description MeshKit's probable causes of the error. */
|
|
149
|
+
probableCause?: string[];
|
|
150
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
151
|
+
suggestedRemediation?: string[];
|
|
152
|
+
};
|
|
153
|
+
};
|
|
154
|
+
};
|
|
155
|
+
/** @description Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session. */
|
|
156
|
+
ClientKeyUnauthorized: {
|
|
157
|
+
headers: {
|
|
158
|
+
[name: string]: unknown;
|
|
159
|
+
};
|
|
160
|
+
content: {
|
|
161
|
+
"application/json": {
|
|
162
|
+
/** @description The refusal, for example "Client key required for operation is invalid or missing". */
|
|
163
|
+
message: string;
|
|
164
|
+
};
|
|
165
|
+
};
|
|
166
|
+
};
|
|
167
|
+
/** @description The request body exceeds the 16 KB cap. Do not retry the same body. */
|
|
168
|
+
PayloadTooLarge: {
|
|
169
|
+
headers: {
|
|
170
|
+
[name: string]: unknown;
|
|
171
|
+
};
|
|
172
|
+
content: {
|
|
173
|
+
"application/json": {
|
|
174
|
+
/** @description The sentence the caller is shown. */
|
|
175
|
+
error: string;
|
|
176
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
177
|
+
code?: string;
|
|
178
|
+
/**
|
|
179
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
180
|
+
* @enum {string}
|
|
181
|
+
*/
|
|
182
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
183
|
+
/** @description MeshKit's probable causes of the error. */
|
|
184
|
+
probableCause?: string[];
|
|
185
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
186
|
+
suggestedRemediation?: string[];
|
|
187
|
+
};
|
|
188
|
+
};
|
|
189
|
+
};
|
|
190
|
+
/** @description Rate limit exceeded; retry after the Retry-After interval. */
|
|
191
|
+
RateLimited: {
|
|
192
|
+
headers: {
|
|
193
|
+
/** @description Seconds to wait before retrying; always a whole number of at least 1. */
|
|
194
|
+
"Retry-After"?: number;
|
|
195
|
+
[name: string]: unknown;
|
|
196
|
+
};
|
|
197
|
+
content: {
|
|
198
|
+
"application/json": {
|
|
199
|
+
/** @description The sentence the caller is shown. */
|
|
200
|
+
error: string;
|
|
201
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
202
|
+
code?: string;
|
|
203
|
+
/**
|
|
204
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
205
|
+
* @enum {string}
|
|
206
|
+
*/
|
|
207
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
208
|
+
/** @description MeshKit's probable causes of the error. */
|
|
209
|
+
probableCause?: string[];
|
|
210
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
211
|
+
suggestedRemediation?: string[];
|
|
212
|
+
};
|
|
213
|
+
};
|
|
214
|
+
};
|
|
215
|
+
/** @description Bad gateway - an upstream service the operation depends on could not be reached or rejected the request */
|
|
216
|
+
MeshkitError502: {
|
|
217
|
+
headers: {
|
|
218
|
+
[name: string]: unknown;
|
|
219
|
+
};
|
|
220
|
+
content: {
|
|
221
|
+
"application/json": {
|
|
222
|
+
/** @description The sentence the caller is shown. */
|
|
223
|
+
error: string;
|
|
224
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
225
|
+
code?: string;
|
|
226
|
+
/**
|
|
227
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
228
|
+
* @enum {string}
|
|
229
|
+
*/
|
|
230
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
231
|
+
/** @description MeshKit's probable causes of the error. */
|
|
232
|
+
probableCause?: string[];
|
|
233
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
234
|
+
suggestedRemediation?: string[];
|
|
235
|
+
};
|
|
236
|
+
};
|
|
237
|
+
};
|
|
58
238
|
};
|
|
59
239
|
parameters: never;
|
|
60
240
|
requestBodies: never;
|
|
@@ -129,4 +309,197 @@ export interface operations {
|
|
|
129
309
|
};
|
|
130
310
|
};
|
|
131
311
|
};
|
|
312
|
+
submitAnonymousSupportRequest: {
|
|
313
|
+
parameters: {
|
|
314
|
+
query?: never;
|
|
315
|
+
header?: never;
|
|
316
|
+
path?: never;
|
|
317
|
+
cookie?: never;
|
|
318
|
+
};
|
|
319
|
+
requestBody: {
|
|
320
|
+
content: {
|
|
321
|
+
"application/json": {
|
|
322
|
+
/**
|
|
323
|
+
* Subject
|
|
324
|
+
* @description Concise and descriptive title for the support request.
|
|
325
|
+
*/
|
|
326
|
+
subject: string;
|
|
327
|
+
/**
|
|
328
|
+
* Description
|
|
329
|
+
* @description Detailed description of the issue or question.
|
|
330
|
+
*/
|
|
331
|
+
message: string;
|
|
332
|
+
/**
|
|
333
|
+
* Scope
|
|
334
|
+
* @description Category that best represents the nature of the inquiry.
|
|
335
|
+
* @enum {string}
|
|
336
|
+
*/
|
|
337
|
+
scope?: "Support" | "Community" | "Account" | "Commercial";
|
|
338
|
+
/**
|
|
339
|
+
* Email
|
|
340
|
+
* Format: email
|
|
341
|
+
* @description Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client.
|
|
342
|
+
*/
|
|
343
|
+
email?: string;
|
|
344
|
+
/**
|
|
345
|
+
* Diagnostic ID
|
|
346
|
+
* Format: uuid
|
|
347
|
+
* @description Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic.
|
|
348
|
+
*/
|
|
349
|
+
diagnosticId?: string;
|
|
350
|
+
};
|
|
351
|
+
};
|
|
352
|
+
};
|
|
353
|
+
responses: {
|
|
354
|
+
/** @description Support request received and forwarded */
|
|
355
|
+
200: {
|
|
356
|
+
headers: {
|
|
357
|
+
[name: string]: unknown;
|
|
358
|
+
};
|
|
359
|
+
content: {
|
|
360
|
+
"application/json": {
|
|
361
|
+
/**
|
|
362
|
+
* @description Always `received`.
|
|
363
|
+
* @enum {string}
|
|
364
|
+
*/
|
|
365
|
+
status: "received";
|
|
366
|
+
/**
|
|
367
|
+
* Format: uuid
|
|
368
|
+
* @description Echoes the request's diagnosticId; omitted when the request linked none.
|
|
369
|
+
*/
|
|
370
|
+
diagnosticId?: string;
|
|
371
|
+
};
|
|
372
|
+
};
|
|
373
|
+
};
|
|
374
|
+
/** @description Invalid request body or request param */
|
|
375
|
+
400: {
|
|
376
|
+
headers: {
|
|
377
|
+
[name: string]: unknown;
|
|
378
|
+
};
|
|
379
|
+
content: {
|
|
380
|
+
"application/json": {
|
|
381
|
+
/** @description The sentence the caller is shown. */
|
|
382
|
+
error: string;
|
|
383
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
384
|
+
code?: string;
|
|
385
|
+
/**
|
|
386
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
387
|
+
* @enum {string}
|
|
388
|
+
*/
|
|
389
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
390
|
+
/** @description MeshKit's probable causes of the error. */
|
|
391
|
+
probableCause?: string[];
|
|
392
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
393
|
+
suggestedRemediation?: string[];
|
|
394
|
+
};
|
|
395
|
+
};
|
|
396
|
+
};
|
|
397
|
+
/** @description Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session. */
|
|
398
|
+
401: {
|
|
399
|
+
headers: {
|
|
400
|
+
[name: string]: unknown;
|
|
401
|
+
};
|
|
402
|
+
content: {
|
|
403
|
+
"application/json": {
|
|
404
|
+
/** @description The refusal, for example "Client key required for operation is invalid or missing". */
|
|
405
|
+
message: string;
|
|
406
|
+
};
|
|
407
|
+
};
|
|
408
|
+
};
|
|
409
|
+
/** @description The request body exceeds the 16 KB cap. Do not retry the same body. */
|
|
410
|
+
413: {
|
|
411
|
+
headers: {
|
|
412
|
+
[name: string]: unknown;
|
|
413
|
+
};
|
|
414
|
+
content: {
|
|
415
|
+
"application/json": {
|
|
416
|
+
/** @description The sentence the caller is shown. */
|
|
417
|
+
error: string;
|
|
418
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
419
|
+
code?: string;
|
|
420
|
+
/**
|
|
421
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
422
|
+
* @enum {string}
|
|
423
|
+
*/
|
|
424
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
425
|
+
/** @description MeshKit's probable causes of the error. */
|
|
426
|
+
probableCause?: string[];
|
|
427
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
428
|
+
suggestedRemediation?: string[];
|
|
429
|
+
};
|
|
430
|
+
};
|
|
431
|
+
};
|
|
432
|
+
/** @description Rate limit exceeded; retry after the Retry-After interval. */
|
|
433
|
+
429: {
|
|
434
|
+
headers: {
|
|
435
|
+
/** @description Seconds to wait before retrying; always a whole number of at least 1. */
|
|
436
|
+
"Retry-After"?: number;
|
|
437
|
+
[name: string]: unknown;
|
|
438
|
+
};
|
|
439
|
+
content: {
|
|
440
|
+
"application/json": {
|
|
441
|
+
/** @description The sentence the caller is shown. */
|
|
442
|
+
error: string;
|
|
443
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
444
|
+
code?: string;
|
|
445
|
+
/**
|
|
446
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
447
|
+
* @enum {string}
|
|
448
|
+
*/
|
|
449
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
450
|
+
/** @description MeshKit's probable causes of the error. */
|
|
451
|
+
probableCause?: string[];
|
|
452
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
453
|
+
suggestedRemediation?: string[];
|
|
454
|
+
};
|
|
455
|
+
};
|
|
456
|
+
};
|
|
457
|
+
/** @description Internal server error */
|
|
458
|
+
500: {
|
|
459
|
+
headers: {
|
|
460
|
+
[name: string]: unknown;
|
|
461
|
+
};
|
|
462
|
+
content: {
|
|
463
|
+
"application/json": {
|
|
464
|
+
/** @description The sentence the caller is shown. */
|
|
465
|
+
error: string;
|
|
466
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
467
|
+
code?: string;
|
|
468
|
+
/**
|
|
469
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
470
|
+
* @enum {string}
|
|
471
|
+
*/
|
|
472
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
473
|
+
/** @description MeshKit's probable causes of the error. */
|
|
474
|
+
probableCause?: string[];
|
|
475
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
476
|
+
suggestedRemediation?: string[];
|
|
477
|
+
};
|
|
478
|
+
};
|
|
479
|
+
};
|
|
480
|
+
/** @description Bad gateway - an upstream service the operation depends on could not be reached or rejected the request */
|
|
481
|
+
502: {
|
|
482
|
+
headers: {
|
|
483
|
+
[name: string]: unknown;
|
|
484
|
+
};
|
|
485
|
+
content: {
|
|
486
|
+
"application/json": {
|
|
487
|
+
/** @description The sentence the caller is shown. */
|
|
488
|
+
error: string;
|
|
489
|
+
/** @description MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error. */
|
|
490
|
+
code?: string;
|
|
491
|
+
/**
|
|
492
|
+
* @description MeshKit severity name. Omitted when MeshKit reports none.
|
|
493
|
+
* @enum {string}
|
|
494
|
+
*/
|
|
495
|
+
severity?: "emergency" | "alert" | "critical" | "fatal";
|
|
496
|
+
/** @description MeshKit's probable causes of the error. */
|
|
497
|
+
probableCause?: string[];
|
|
498
|
+
/** @description MeshKit's suggested remediations for the error. */
|
|
499
|
+
suggestedRemediation?: string[];
|
|
500
|
+
};
|
|
501
|
+
};
|
|
502
|
+
};
|
|
503
|
+
};
|
|
504
|
+
};
|
|
132
505
|
}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
'use strict';var e={openapi:"3.0.0",info:{title:"Support",description:"OpenAPI schema for Meshery help-and-support request submission.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"Support",description:"Operations related to help and support requests"}],paths:{"/api/integrations/support":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit a support request",operationId:"submitSupportRequest",requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},responses:{201:{description:"Support request submitted",content:{"application/json":{schema:{type:"object",properties:{message:{type:"string"}}}}}},400:{description:"Invalid request format"},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}}},securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{SupportRequest:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},t=e;
|
|
1
|
+
'use strict';var e={openapi:"3.0.0",info:{title:"Support",description:"OpenAPI schema for Meshery help-and-support request submission.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"Support",description:"Operations related to help and support requests"}],paths:{"/api/integrations/support":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit a support request",operationId:"submitSupportRequest",requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},responses:{201:{description:"Support request submitted",content:{"application/json":{schema:{type:"object",properties:{message:{type:"string"}}}}}},400:{description:"Invalid request format"},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}},"/api/support/anonymous":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit an anonymous support request",description:'Accepts a support request without requiring a signed-in user, so a desktop client can offer a "Contact support" action whether or not the person is signed in. A signed-out client authenticates with the same per-client-kind `X-Client-Key` as submitFailureDiagnostic; a signed-in caller may use its bearer token instead, and only then is the organization attached. A request carrying neither is a 401. The email address is only ever sent when the person types it in, and diagnosticId links this report to the automatic failure diagnostic submitted for the same incident, when one exists. Served by Layer5 Cloud; see Blowhorn issue #771.',operationId:"submitAnonymousSupportRequest",security:[{clientKey:[]},{jwt:[]}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request without signing in. It carries the same subject, message, and scope as SupportRequest, plus two optional fields: an email address the person typed in for a follow-up, and the diagnosticId of the automatic failure diagnostic for the same incident, when one was submitted. The fields are spelled out here rather than composed with allOf so generated clients expose them flat, exactly like SupportRequest. The object is closed: Cloud decodes it strictly and refuses an unknown field with a 400.",additionalProperties:false,required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."},email:{type:"string",title:"Email",format:"email",maxLength:254,description:"Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client."},diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic."}}}}}},responses:{200:{description:"Support request received and forwarded",content:{"application/json":{schema:{type:"object",additionalProperties:false,required:["status"],properties:{status:{type:"string",enum:["received"],description:"Always `received`."},diagnosticId:{type:"string",format:"uuid",description:"Echoes the request's diagnosticId; omitted when the request linked none."}}}}}},400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},401:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},413:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},429:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},502:{description:"Bad gateway - an upstream service the operation depends on could not be reached or rejected the request",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},MeshkitError500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},ClientKeyUnauthorized:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},PayloadTooLarge:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},RateLimited:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},MeshkitError502:{description:"Bad gateway - an upstream service the operation depends on could not be reached or rejected the request",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}},securitySchemes:{clientKey:{type:"apiKey",in:"header",name:"X-Client-Key",description:"Per-client-kind, per-release-channel pre-shared key, of the form `<key id>.<secret>`. The same key authenticates submitFailureDiagnostic (v1beta1/diagnostics)."},jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{SupportRequest:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}},AnonymousSupportRequest:{type:"object",description:"Payload for submitting a help-and-support request without signing in. It carries the same subject, message, and scope as SupportRequest, plus two optional fields: an email address the person typed in for a follow-up, and the diagnosticId of the automatic failure diagnostic for the same incident, when one was submitted. The fields are spelled out here rather than composed with allOf so generated clients expose them flat, exactly like SupportRequest. The object is closed: Cloud decodes it strictly and refuses an unknown field with a 400.",additionalProperties:false,required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."},email:{type:"string",title:"Email",format:"email",maxLength:254,description:"Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client."},diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic."}}}}}},t=e;
|
|
2
2
|
module.exports=t;
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
var e={openapi:"3.0.0",info:{title:"Support",description:"OpenAPI schema for Meshery help-and-support request submission.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"Support",description:"Operations related to help and support requests"}],paths:{"/api/integrations/support":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit a support request",operationId:"submitSupportRequest",requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},responses:{201:{description:"Support request submitted",content:{"application/json":{schema:{type:"object",properties:{message:{type:"string"}}}}}},400:{description:"Invalid request format"},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}}},securitySchemes:{jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{SupportRequest:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},t=e;
|
|
1
|
+
var e={openapi:"3.0.0",info:{title:"Support",description:"OpenAPI schema for Meshery help-and-support request submission.",version:"v1beta1",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"Support",description:"Operations related to help and support requests"}],paths:{"/api/integrations/support":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit a support request",operationId:"submitSupportRequest",requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}}}}},responses:{201:{description:"Support request submitted",content:{"application/json":{schema:{type:"object",properties:{message:{type:"string"}}}}}},400:{description:"Invalid request format"},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error"}}}},"/api/support/anonymous":{post:{"x-internal":["cloud"],tags:["Support"],summary:"Submit an anonymous support request",description:'Accepts a support request without requiring a signed-in user, so a desktop client can offer a "Contact support" action whether or not the person is signed in. A signed-out client authenticates with the same per-client-kind `X-Client-Key` as submitFailureDiagnostic; a signed-in caller may use its bearer token instead, and only then is the organization attached. A request carrying neither is a 401. The email address is only ever sent when the person types it in, and diagnosticId links this report to the automatic failure diagnostic submitted for the same incident, when one exists. Served by Layer5 Cloud; see Blowhorn issue #771.',operationId:"submitAnonymousSupportRequest",security:[{clientKey:[]},{jwt:[]}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for submitting a help-and-support request without signing in. It carries the same subject, message, and scope as SupportRequest, plus two optional fields: an email address the person typed in for a follow-up, and the diagnosticId of the automatic failure diagnostic for the same incident, when one was submitted. The fields are spelled out here rather than composed with allOf so generated clients expose them flat, exactly like SupportRequest. The object is closed: Cloud decodes it strictly and refuses an unknown field with a 400.",additionalProperties:false,required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."},email:{type:"string",title:"Email",format:"email",maxLength:254,description:"Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client."},diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic."}}}}}},responses:{200:{description:"Support request received and forwarded",content:{"application/json":{schema:{type:"object",additionalProperties:false,required:["status"],properties:{status:{type:"string",enum:["received"],description:"Always `received`."},diagnosticId:{type:"string",format:"uuid",description:"Echoes the request's diagnosticId; omitted when the request linked none."}}}}}},400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},401:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},413:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},429:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},502:{description:"Bad gateway - an upstream service the operation depends on could not be reached or rejected the request",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}}}}},components:{responses:{401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError400:{description:"Invalid request body or request param",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},MeshkitError500:{description:"Internal server error",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},ClientKeyUnauthorized:{description:"Neither a signed-in session nor a valid X-Client-Key. A missing, revoked, expired, not-yet-valid or unknown key all answer alike, so key existence is not an oracle. Rotate the client key; this is not an expired session.",content:{"application/json":{schema:{type:"object",required:["message"],properties:{message:{type:"string",description:'The refusal, for example "Client key required for operation is invalid or missing".'}}}}}},PayloadTooLarge:{description:"The request body exceeds the 16 KB cap. Do not retry the same body.",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},RateLimited:{description:"Rate limit exceeded; retry after the Retry-After interval.",headers:{"Retry-After":{description:"Seconds to wait before retrying; always a whole number of at least 1.",schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},MeshkitError502:{description:"Bad gateway - an upstream service the operation depends on could not be reached or rejected the request",content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}},securitySchemes:{clientKey:{type:"apiKey",in:"header",name:"X-Client-Key",description:"Per-client-kind, per-release-channel pre-shared key, of the form `<key id>.<secret>`. The same key authenticates submitFailureDiagnostic (v1beta1/diagnostics)."},jwt:{type:"http",scheme:"bearer",bearerFormat:"JWT"}},schemas:{SupportRequest:{type:"object",description:"Payload for submitting a help-and-support request.",required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."}}},AnonymousSupportRequest:{type:"object",description:"Payload for submitting a help-and-support request without signing in. It carries the same subject, message, and scope as SupportRequest, plus two optional fields: an email address the person typed in for a follow-up, and the diagnosticId of the automatic failure diagnostic for the same incident, when one was submitted. The fields are spelled out here rather than composed with allOf so generated clients expose them flat, exactly like SupportRequest. The object is closed: Cloud decodes it strictly and refuses an unknown field with a 400.",additionalProperties:false,required:["subject","message"],properties:{subject:{type:"string",title:"Subject",minLength:1,maxLength:255,description:"Concise and descriptive title for the support request."},message:{type:"string",title:"Description",minLength:10,description:"Detailed description of the issue or question."},scope:{type:"string",title:"Scope",enum:["Support","Community","Account","Commercial"],description:"Category that best represents the nature of the inquiry."},email:{type:"string",title:"Email",format:"email",maxLength:254,description:"Optional email address the person typed in for a follow-up. Absent when they did not ask to be contacted; never inferred from an account, because this request may come from a signed-out client."},diagnosticId:{type:"string",title:"Diagnostic ID",format:"uuid",description:"Optional id of the FailureDiagnostic submitted for the same incident (schemas/constructs/v1beta1/diagnostics/api.yml), linking the human report to the automatic diagnostic."}}}}}},t=e;
|
|
2
2
|
export{t as default};
|