@meshery/schemas 1.3.72 → 1.3.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/dist/cloudApi.d.mts +23587 -20833
  2. package/dist/cloudApi.d.ts +23587 -20833
  3. package/dist/cloudApi.js +1 -1
  4. package/dist/cloudApi.mjs +1 -1
  5. package/dist/constructs/v1beta2/schedule/Schedule.d.ts +4 -0
  6. package/dist/constructs/v1beta2/schedule/ScheduleSchema.js +7 -4
  7. package/dist/constructs/v1beta2/schedule/ScheduleSchema.mjs +7 -4
  8. package/dist/constructs/v1beta3/academy/Academy.d.ts +9 -9
  9. package/dist/constructs/v1beta3/academy/AcademySchema.js +2 -2
  10. package/dist/constructs/v1beta3/academy/AcademySchema.mjs +2 -2
  11. package/dist/constructs/v1beta3/claim/Claim.d.ts +919 -0
  12. package/dist/constructs/v1beta3/claim/ClaimSchema.d.ts +2 -0
  13. package/dist/constructs/v1beta3/claim/ClaimSchema.js +88 -0
  14. package/dist/constructs/v1beta3/claim/ClaimSchema.mjs +88 -0
  15. package/dist/constructs/v1beta3/connection/Connection.d.ts +5 -0
  16. package/dist/constructs/v1beta3/connection/ConnectionSchema.js +1 -1
  17. package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +1 -1
  18. package/dist/constructs/v1beta3/{blowhorn_content/BlowhornContent.d.ts → content_piece/ContentPiece.d.ts} +101 -83
  19. package/dist/constructs/v1beta3/content_piece/ContentPieceSchema.d.ts +2 -0
  20. package/dist/constructs/v1beta3/content_piece/ContentPieceSchema.js +48 -0
  21. package/dist/constructs/v1beta3/content_piece/ContentPieceSchema.mjs +48 -0
  22. package/dist/constructs/v1beta3/invitation/Invitation.d.ts +33 -33
  23. package/dist/constructs/v1beta3/invitation/InvitationSchema.js +1 -1
  24. package/dist/constructs/v1beta3/invitation/InvitationSchema.mjs +1 -1
  25. package/dist/constructs/v1beta3/schedule/Schedule.d.ts +3804 -0
  26. package/dist/constructs/v1beta3/schedule/Schedule.js +1 -0
  27. package/dist/constructs/v1beta3/schedule/Schedule.mjs +0 -0
  28. package/dist/constructs/v1beta3/schedule/ScheduleSchema.d.ts +2 -0
  29. package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +61 -0
  30. package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +61 -0
  31. package/dist/index.d.mts +17 -1
  32. package/dist/index.d.ts +17 -1
  33. package/dist/index.js +2 -2
  34. package/dist/index.mjs +2 -2
  35. package/package.json +1 -1
  36. package/dist/constructs/v1beta3/blowhorn_content/BlowhornContentSchema.d.ts +0 -2
  37. package/dist/constructs/v1beta3/blowhorn_content/BlowhornContentSchema.js +0 -43
  38. package/dist/constructs/v1beta3/blowhorn_content/BlowhornContentSchema.mjs +0 -43
  39. package/dist/constructs/v1beta3/job_lease/JobLease.d.ts +0 -2570
  40. package/dist/constructs/v1beta3/job_lease/JobLeaseSchema.d.ts +0 -2
  41. package/dist/constructs/v1beta3/job_lease/JobLeaseSchema.js +0 -83
  42. package/dist/constructs/v1beta3/job_lease/JobLeaseSchema.mjs +0 -83
  43. /package/dist/constructs/v1beta3/{blowhorn_content/BlowhornContent.js → claim/Claim.js} +0 -0
  44. /package/dist/constructs/v1beta3/{blowhorn_content/BlowhornContent.mjs → claim/Claim.mjs} +0 -0
  45. /package/dist/constructs/v1beta3/{job_lease/JobLease.js → content_piece/ContentPiece.js} +0 -0
  46. /package/dist/constructs/v1beta3/{job_lease/JobLease.mjs → content_piece/ContentPiece.mjs} +0 -0
@@ -0,0 +1,2 @@
1
+ declare const ClaimSchema: Record<string, unknown>;
2
+ export default ClaimSchema;
@@ -0,0 +1,88 @@
1
+ 'use strict';var e={openapi:"3.0.0",info:{title:"Claim",description:`OpenAPI schema for claims - generic, time-bound holds that one claimant
2
+ takes on one resource so competing workers never act on it twice. Any
3
+ construct can be claimed; schedules nest the same claim under
4
+ \`/api/schedules/{scheduleId}/claim\`. The race between claimants is
5
+ decided server-side in a single statement. Only the holder renews or
6
+ releases a claim; a claim past \`expiresAt\` is stale and the resource can
7
+ be claimed again.
8
+ Organization scope: every operation acts only in the organization the
9
+ session resolved to (X-Current-Orgid, then the user's selected
10
+ organization), and only when the caller is a live member of it. A
11
+ caller who is not a member receives the same 404 as an unknown id, so
12
+ the existence of another organization's claims is never disclosed.
13
+ `,version:"v1beta3",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:"claims",description:"Operations related to claims on resources."}],paths:{"/api/claims":{get:{"x-internal":["cloud"],tags:["claims"],summary:"List claims",operationId:"listClaims",description:"Returns a paginated list of claims in the organization of the authenticated session, optionally filtered by resource, claimant or status.",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page.",schema:{type:"integer",minimum:1}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"resourceType",in:"query",required:false,description:"Filter by claimed resource type.",schema:{type:"string",maxLength:64}},{name:"resourceId",in:"query",required:false,description:"Filter by claimed resource ID.",schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},{name:"claimant",in:"query",required:false,description:"Filter by holder identity.",schema:{type:"string",maxLength:255}},{name:"status",in:"query",required:false,description:"Filter by claim status.",schema:{type:"string",enum:["active","released","expired"]}}],responses:{200:{description:"Claims page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of claims.",required:["page","pageSize","totalCount","claims"],properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},claims:{type:"array",items:{"x-go-type":"Claim",$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
14
+ resource so that competing workers never act on it twice. A claim is
15
+ generic: it names the resource it holds by type and ID, and any construct
16
+ can be claimed (a schedule is the first). A claim is live while its
17
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
18
+ another claimant refuses a new claim on the same resource. A claim whose
19
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
20
+ so a claimant that disappears never strands the resource. Only the
21
+ holder renews or releases a claim. The race between claimants is decided
22
+ server-side in a single statement.
23
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},description:"Claims included on this page of results."}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},post:{"x-internal":["cloud"],tags:["claims"],summary:"Claim a resource",operationId:"createClaim",description:`Takes a claim on the named resource for \`claimant\`. Succeeds when the
24
+ resource has no live claim or its live claim already belongs to the
25
+ same claimant; a live claim held by another claimant answers 409. A
26
+ stale claim (past \`expiresAt\`) is superseded. Decided in a single
27
+ server-side statement, so of two racing claimants exactly one wins.
28
+ `,requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for taking a claim. Contains only client-settable fields;\nthe owning `organizationId`, `status`, `claimedAt`, `expiresAt` and\nthe timestamps are server-managed.\n",required:["resourceType","resourceId","claimant"],properties:{resourceType:{type:"string",description:"Type of the resource to claim, for example `schedule`.",minLength:1,maxLength:64},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},claimant:{type:"string",description:"Identity of the worker taking the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested claim duration in minutes; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}}}}},responses:{201:{description:"Claim taken",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
29
+ resource so that competing workers never act on it twice. A claim is
30
+ generic: it names the resource it holds by type and ID, and any construct
31
+ can be claimed (a schedule is the first). A claim is live while its
32
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
33
+ another claimant refuses a new claim on the same resource. A claim whose
34
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
35
+ so a claimant that disappears never strands the resource. Only the
36
+ holder renews or releases a claim. The race between claimants is decided
37
+ server-side in a single statement.
38
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}":{get:{"x-internal":["cloud"],tags:["claims"],summary:"Get a claim by ID",operationId:"getClaim",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],responses:{200:{description:"Claim response",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
39
+ resource so that competing workers never act on it twice. A claim is
40
+ generic: it names the resource it holds by type and ID, and any construct
41
+ can be claimed (a schedule is the first). A claim is live while its
42
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
43
+ another claimant refuses a new claim on the same resource. A claim whose
44
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
45
+ so a claimant that disappears never strands the resource. Only the
46
+ holder renews or releases a claim. The race between claimants is decided
47
+ server-side in a single statement.
48
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}/renew":{post:{"x-internal":["cloud"],tags:["claims"],summary:"Renew a claim",operationId:"renewClaim",description:"Moves `expiresAt` forward for the holder only. A claim that is not active, or that belongs to another claimant, answers 409 and is never taken back.",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for renewing a claim. Only the holder named by `claimant` may renew.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder renewing the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested extension in minutes from now; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}}}}},responses:{200:{description:"Claim renewed",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
49
+ resource so that competing workers never act on it twice. A claim is
50
+ generic: it names the resource it holds by type and ID, and any construct
51
+ can be claimed (a schedule is the first). A claim is live while its
52
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
53
+ another claimant refuses a new claim on the same resource. A claim whose
54
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
55
+ so a claimant that disappears never strands the resource. Only the
56
+ holder renews or releases a claim. The race between claimants is decided
57
+ server-side in a single statement.
58
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}/release":{post:{"x-internal":["cloud"],tags:["claims"],summary:"Release a claim",operationId:"releaseClaim",description:"Ends the claim for the holder, setting `status` to `released` and `releasedAt`. Releasing a claim that is already released is a no-op; a release by another claimant answers 409.",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for releasing a claim. Only the holder named by `claimant` may release.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder releasing the claim.",minLength:1,maxLength:255}}}}}},responses:{200:{description:"Claim released",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
59
+ resource so that competing workers never act on it twice. A claim is
60
+ generic: it names the resource it holds by type and ID, and any construct
61
+ can be claimed (a schedule is the first). A claim is live while its
62
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
63
+ another claimant refuses a new claim on the same resource. A claim whose
64
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
65
+ so a claimant that disappears never strands the resource. Only the
66
+ holder renews or releases a claim. The race between claimants is decided
67
+ server-side in a single statement.
68
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"Bearer [REDACTED]",bearerFormat:"JWT"}},responses:{400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}},parameters:{claimId:{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page.",schema:{type:"integer",minimum:1}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{Claim:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
69
+ resource so that competing workers never act on it twice. A claim is
70
+ generic: it names the resource it holds by type and ID, and any construct
71
+ can be claimed (a schedule is the first). A claim is live while its
72
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
73
+ another claimant refuses a new claim on the same resource. A claim whose
74
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
75
+ so a claimant that disappears never strands the resource. Only the
76
+ holder renews or releases a claim. The race between claimants is decided
77
+ server-side in a single statement.
78
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},ClaimPayload:{type:"object",description:"Payload for taking a claim. Contains only client-settable fields;\nthe owning `organizationId`, `status`, `claimedAt`, `expiresAt` and\nthe timestamps are server-managed.\n",required:["resourceType","resourceId","claimant"],properties:{resourceType:{type:"string",description:"Type of the resource to claim, for example `schedule`.",minLength:1,maxLength:64},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},claimant:{type:"string",description:"Identity of the worker taking the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested claim duration in minutes; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}},ClaimRenewPayload:{type:"object",description:"Payload for renewing a claim. Only the holder named by `claimant` may renew.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder renewing the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested extension in minutes from now; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}},ClaimReleasePayload:{type:"object",description:"Payload for releasing a claim. Only the holder named by `claimant` may release.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder releasing the claim.",minLength:1,maxLength:255}}},ClaimPage:{type:"object",description:"Paginated collection of claims.",required:["page","pageSize","totalCount","claims"],properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},claims:{type:"array",items:{"x-go-type":"Claim",$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
79
+ resource so that competing workers never act on it twice. A claim is
80
+ generic: it names the resource it holds by type and ID, and any construct
81
+ can be claimed (a schedule is the first). A claim is live while its
82
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
83
+ another claimant refuses a new claim on the same resource. A claim whose
84
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
85
+ so a claimant that disappears never strands the resource. Only the
86
+ holder renews or releases a claim. The race between claimants is decided
87
+ server-side in a single statement.
88
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},description:"Claims included on this page of results."}}}}}},t=e;module.exports=t;
@@ -0,0 +1,88 @@
1
+ var e={openapi:"3.0.0",info:{title:"Claim",description:`OpenAPI schema for claims - generic, time-bound holds that one claimant
2
+ takes on one resource so competing workers never act on it twice. Any
3
+ construct can be claimed; schedules nest the same claim under
4
+ \`/api/schedules/{scheduleId}/claim\`. The race between claimants is
5
+ decided server-side in a single statement. Only the holder renews or
6
+ releases a claim; a claim past \`expiresAt\` is stale and the resource can
7
+ be claimed again.
8
+ Organization scope: every operation acts only in the organization the
9
+ session resolved to (X-Current-Orgid, then the user's selected
10
+ organization), and only when the caller is a live member of it. A
11
+ caller who is not a member receives the same 404 as an unknown id, so
12
+ the existence of another organization's claims is never disclosed.
13
+ `,version:"v1beta3",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:"claims",description:"Operations related to claims on resources."}],paths:{"/api/claims":{get:{"x-internal":["cloud"],tags:["claims"],summary:"List claims",operationId:"listClaims",description:"Returns a paginated list of claims in the organization of the authenticated session, optionally filtered by resource, claimant or status.",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page.",schema:{type:"integer",minimum:1}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"resourceType",in:"query",required:false,description:"Filter by claimed resource type.",schema:{type:"string",maxLength:64}},{name:"resourceId",in:"query",required:false,description:"Filter by claimed resource ID.",schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},{name:"claimant",in:"query",required:false,description:"Filter by holder identity.",schema:{type:"string",maxLength:255}},{name:"status",in:"query",required:false,description:"Filter by claim status.",schema:{type:"string",enum:["active","released","expired"]}}],responses:{200:{description:"Claims page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of claims.",required:["page","pageSize","totalCount","claims"],properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},claims:{type:"array",items:{"x-go-type":"Claim",$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
14
+ resource so that competing workers never act on it twice. A claim is
15
+ generic: it names the resource it holds by type and ID, and any construct
16
+ can be claimed (a schedule is the first). A claim is live while its
17
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
18
+ another claimant refuses a new claim on the same resource. A claim whose
19
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
20
+ so a claimant that disappears never strands the resource. Only the
21
+ holder renews or releases a claim. The race between claimants is decided
22
+ server-side in a single statement.
23
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},description:"Claims included on this page of results."}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},post:{"x-internal":["cloud"],tags:["claims"],summary:"Claim a resource",operationId:"createClaim",description:`Takes a claim on the named resource for \`claimant\`. Succeeds when the
24
+ resource has no live claim or its live claim already belongs to the
25
+ same claimant; a live claim held by another claimant answers 409. A
26
+ stale claim (past \`expiresAt\`) is superseded. Decided in a single
27
+ server-side statement, so of two racing claimants exactly one wins.
28
+ `,requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for taking a claim. Contains only client-settable fields;\nthe owning `organizationId`, `status`, `claimedAt`, `expiresAt` and\nthe timestamps are server-managed.\n",required:["resourceType","resourceId","claimant"],properties:{resourceType:{type:"string",description:"Type of the resource to claim, for example `schedule`.",minLength:1,maxLength:64},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},claimant:{type:"string",description:"Identity of the worker taking the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested claim duration in minutes; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}}}}},responses:{201:{description:"Claim taken",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
29
+ resource so that competing workers never act on it twice. A claim is
30
+ generic: it names the resource it holds by type and ID, and any construct
31
+ can be claimed (a schedule is the first). A claim is live while its
32
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
33
+ another claimant refuses a new claim on the same resource. A claim whose
34
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
35
+ so a claimant that disappears never strands the resource. Only the
36
+ holder renews or releases a claim. The race between claimants is decided
37
+ server-side in a single statement.
38
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}":{get:{"x-internal":["cloud"],tags:["claims"],summary:"Get a claim by ID",operationId:"getClaim",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],responses:{200:{description:"Claim response",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
39
+ resource so that competing workers never act on it twice. A claim is
40
+ generic: it names the resource it holds by type and ID, and any construct
41
+ can be claimed (a schedule is the first). A claim is live while its
42
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
43
+ another claimant refuses a new claim on the same resource. A claim whose
44
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
45
+ so a claimant that disappears never strands the resource. Only the
46
+ holder renews or releases a claim. The race between claimants is decided
47
+ server-side in a single statement.
48
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}/renew":{post:{"x-internal":["cloud"],tags:["claims"],summary:"Renew a claim",operationId:"renewClaim",description:"Moves `expiresAt` forward for the holder only. A claim that is not active, or that belongs to another claimant, answers 409 and is never taken back.",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for renewing a claim. Only the holder named by `claimant` may renew.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder renewing the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested extension in minutes from now; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}}}}},responses:{200:{description:"Claim renewed",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
49
+ resource so that competing workers never act on it twice. A claim is
50
+ generic: it names the resource it holds by type and ID, and any construct
51
+ can be claimed (a schedule is the first). A claim is live while its
52
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
53
+ another claimant refuses a new claim on the same resource. A claim whose
54
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
55
+ so a claimant that disappears never strands the resource. Only the
56
+ holder renews or releases a claim. The race between claimants is decided
57
+ server-side in a single statement.
58
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/claims/{claimId}/release":{post:{"x-internal":["cloud"],tags:["claims"],summary:"Release a claim",operationId:"releaseClaim",description:"Ends the claim for the holder, setting `status` to `released` and `releasedAt`. Releasing a claim that is already released is a no-op; a release by another claimant answers 409.",parameters:[{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for releasing a claim. Only the holder named by `claimant` may release.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder releasing the claim.",minLength:1,maxLength:255}}}}}},responses:{200:{description:"Claim released",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
59
+ resource so that competing workers never act on it twice. A claim is
60
+ generic: it names the resource it holds by type and ID, and any construct
61
+ can be claimed (a schedule is the first). A claim is live while its
62
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
63
+ another claimant refuses a new claim on the same resource. A claim whose
64
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
65
+ so a claimant that disappears never strands the resource. Only the
66
+ holder renews or releases a claim. The race between claimants is decided
67
+ server-side in a single statement.
68
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"Bearer [REDACTED]",bearerFormat:"JWT"}},responses:{400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the resource is held by another claimant's live claim, or the caller is not the holder of the claim it tried to renew or release",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}},parameters:{claimId:{name:"claimId",in:"path",description:"Claim ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page.",schema:{type:"integer",minimum:1}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{Claim:{$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
69
+ resource so that competing workers never act on it twice. A claim is
70
+ generic: it names the resource it holds by type and ID, and any construct
71
+ can be claimed (a schedule is the first). A claim is live while its
72
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
73
+ another claimant refuses a new claim on the same resource. A claim whose
74
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
75
+ so a claimant that disappears never strands the resource. Only the
76
+ holder renews or releases a claim. The race between claimants is decided
77
+ server-side in a single statement.
78
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},ClaimPayload:{type:"object",description:"Payload for taking a claim. Contains only client-settable fields;\nthe owning `organizationId`, `status`, `claimedAt`, `expiresAt` and\nthe timestamps are server-managed.\n",required:["resourceType","resourceId","claimant"],properties:{resourceType:{type:"string",description:"Type of the resource to claim, for example `schedule`.",minLength:1,maxLength:64},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},claimant:{type:"string",description:"Identity of the worker taking the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested claim duration in minutes; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}},ClaimRenewPayload:{type:"object",description:"Payload for renewing a claim. Only the holder named by `claimant` may renew.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder renewing the claim.",minLength:1,maxLength:255},durationMinutes:{type:"integer",description:"Requested extension in minutes from now; the server applies its default when omitted and may cap it.",minimum:1,maximum:1440}}},ClaimReleasePayload:{type:"object",description:"Payload for releasing a claim. Only the holder named by `claimant` may release.",required:["claimant"],properties:{claimant:{type:"string",description:"Identity of the holder releasing the claim.",minLength:1,maxLength:255}}},ClaimPage:{type:"object",description:"Paginated collection of claims.",required:["page","pageSize","totalCount","claims"],properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},claims:{type:"array",items:{"x-go-type":"Claim",$schema:"http://json-schema.org/draft-07/schema#",title:"Claim Schema",description:`Server-returned claim: a time-bound hold that one claimant takes on one
79
+ resource so that competing workers never act on it twice. A claim is
80
+ generic: it names the resource it holds by type and ID, and any construct
81
+ can be claimed (a schedule is the first). A claim is live while its
82
+ status is \`active\` and \`expiresAt\` is in the future; a live claim held by
83
+ another claimant refuses a new claim on the same resource. A claim whose
84
+ \`expiresAt\` has passed is stale and the resource may be claimed again,
85
+ so a claimant that disappears never strands the resource. Only the
86
+ holder renews or releases a claim. The race between claimants is decided
87
+ server-side in a single statement.
88
+ `,type:"object",additionalProperties:false,required:["id","organizationId","resourceType","resourceId","claimant","status","claimedAt","expiresAt","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},resourceType:{type:"string",description:"Type of the claimed resource, for example `schedule`.",minLength:1,maxLength:64,"x-oapi-codegen-extra-tags":{db:"resource_type"},"x-order":3},resourceId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"resource_id"},"x-order":4},claimant:{type:"string",description:"Identity of the holder, as asserted by the worker that took the claim (for example a machine and process identifier).",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"claimant"},"x-order":5},status:{type:"string",description:"Lifecycle of the claim. `active` while held, `released` once the holder lets it go, `expired` once `expiresAt` passed without a renewal.",enum:["active","released","expired"],"x-oapi-codegen-extra-tags":{db:"status"},"x-order":6},claimedAt:{description:"Time the claim was taken.","x-oapi-codegen-extra-tags":{db:"claimed_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},expiresAt:{description:"Time the claim lapses unless the holder renews it. Always set by the server; a claim past this time is stale.","x-oapi-codegen-extra-tags":{db:"expires_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},releasedAt:{type:"string",format:"date-time",description:"Time the holder released the claim. Null while the claim is active or after it expired.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"released_at"},"x-order":9},createdAt:{description:"Timestamp of claim creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":10,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last claim modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":11,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true}}},description:"Claims included on this page of results."}}}}}},t=e;export{t as default};
@@ -593,6 +593,11 @@ export interface components {
593
593
  * @enum {string}
594
594
  */
595
595
  CoreKind: "meshery" | "kubernetes" | "prometheus" | "grafana" | "github";
596
+ /**
597
+ * @description A connection kind that names a publishing destination. A connection of this kind carries the destination's absolute https URL in `metadata.url` and references its secret through `credentialId`. The `kind` field itself remains an open-ended string.
598
+ * @enum {string}
599
+ */
600
+ DestinationKind: "linkedin" | "x" | "reddit" | "hn" | "slack" | "bluesky" | "github" | "blog";
596
601
  /** @description A connection definition is an uninitialized connection, authored per-model (in a model's `connections/` folder) and registered into the registry alongside components and relationships. It conforms to the connection schema; the dynamic, kind-specific shape is carried in `metadata`. The `model` association scopes the definition to its owning model. */
597
602
  ConnectionDefinition: unknown;
598
603
  /** @description Represents a page of connection definitions with meta information about the total count */