@serve.zone/interfaces 32.21.0 → 32.23.0
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/changelog.md +91 -0
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/data/clusteringress.d.ts +58 -0
- package/dist_ts/data/clusteringress.js +96 -2
- package/dist_ts/data/clusteringressdesignation.d.ts +64 -0
- package/dist_ts/data/clusteringressdesignation.js +84 -0
- package/dist_ts/data/corestorelegacyadoption.d.ts +178 -0
- package/dist_ts/data/corestorelegacyadoption.js +289 -0
- package/dist_ts/data/index.d.ts +6 -0
- package/dist_ts/data/index.js +6 -1
- package/dist_ts/data/networkprojection.d.ts +18 -0
- package/dist_ts/data/networkprojection.js +31 -2
- package/dist_ts/data/networkprotection.d.ts +13 -0
- package/dist_ts/data/networkprotection.js +8 -2
- package/dist_ts/data/networkworkloadingress.d.ts +61 -0
- package/dist_ts/data/networkworkloadingress.js +54 -0
- package/dist_ts/data/runtimelocalstorageclaim.d.ts +124 -0
- package/dist_ts/data/runtimelocalstorageclaim.js +167 -0
- package/dist_ts/data/service.d.ts +15 -1
- package/dist_ts/data/service.js +1 -1
- package/dist_ts/data/serviceruntime.d.ts +15 -3
- package/dist_ts/data/serviceruntime.js +7 -2
- package/dist_ts/data/servicevolumeinitialization.d.ts +91 -0
- package/dist_ts/data/servicevolumeinitialization.js +93 -0
- package/dist_ts/platform/types.d.ts +45 -0
- package/dist_ts/platform/types.js +27 -2
- package/dist_ts/private/storagecontract.d.ts +1 -0
- package/dist_ts/private/storagecontract.js +2 -1
- package/dist_ts/requests/clusteringress.d.ts +52 -0
- package/dist_ts/requests/clusteringress.js +1 -1
- package/dist_ts/requests/corestore.d.ts +60 -0
- package/dist_ts/requests/corestore.js +1 -1
- package/dist_ts/requests/platform.d.ts +6 -1
- package/dist_ts/requests/runtimesession.d.ts +12 -0
- package/dist_ts/requests/service.d.ts +23 -0
- package/package.json +1 -1
- package/readme.md +262 -2
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/data/clusteringress.ts +136 -1
- package/ts/data/clusteringressdesignation.ts +141 -0
- package/ts/data/corestorelegacyadoption.ts +471 -0
- package/ts/data/index.ts +7 -0
- package/ts/data/networkprojection.ts +49 -1
- package/ts/data/networkprotection.ts +20 -1
- package/ts/data/networkworkloadingress.ts +107 -0
- package/ts/data/runtimelocalstorageclaim.ts +275 -0
- package/ts/data/service.ts +16 -0
- package/ts/data/serviceruntime.ts +19 -2
- package/ts/data/servicevolumeinitialization.ts +159 -0
- package/ts/platform/types.ts +75 -0
- package/ts/private/storagecontract.ts +1 -0
- package/ts/requests/clusteringress.ts +65 -0
- package/ts/requests/corestore.ts +79 -0
- package/ts/requests/platform.ts +6 -0
- package/ts/requests/runtimesession.ts +16 -0
- package/ts/requests/service.ts +28 -0
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import type { IObjectStorageRetentionIntent } from '../platform/objectstorageretention.js';
|
|
2
|
+
import type { TPlatformBindingStatusReason } from '../platform/types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Moving a service's legacy Corestore resources into credential bindings.
|
|
5
|
+
*
|
|
6
|
+
* A Corestore root converted from a release before 32 still holds the databases and buckets
|
|
7
|
+
* `/resources/provision` created, one per service and capability, in its manifest. Corestore
|
|
8
|
+
* refuses a credential binding beside such a resource until an operator authorizes that exact
|
|
9
|
+
* binding to adopt it, offline, with a plan file. The flow across the three owners:
|
|
10
|
+
*
|
|
11
|
+
* 1. Corestore answers `GET /control/legacy-resources` with its `ICorestoreLegacyResourceInventory`;
|
|
12
|
+
* the cluster relay reads it for Cloudly (`getClusterCorestoreLegacyResources`).
|
|
13
|
+
* 2. `adoptCorestoreLegacyResources` checks the admin's selection against that inventory at an
|
|
14
|
+
* exact digest, creates each adopting binding with the legacy bucket and retention intent, and
|
|
15
|
+
* answers the plan (`ICorestoreLegacyResourceAdoptionPlanEntry[]`).
|
|
16
|
+
* 3. The operator stops Corestore and runs its `legacy-resource-adoption` migration with that plan.
|
|
17
|
+
* Until then Corestore refuses the binding, which reports `legacy-adoption-pending`.
|
|
18
|
+
*/
|
|
19
|
+
export type TCorestoreLegacyCapability = 'database' | 'objectstorage';
|
|
20
|
+
/**
|
|
21
|
+
* Why Corestore's offline adoption would refuse an unadopted resource:
|
|
22
|
+
*
|
|
23
|
+
* - `not-adoptable`: its identity is not what a credential binding can adopt (an
|
|
24
|
+
* allocation-managed database, another provider, a resource name that differs from its database
|
|
25
|
+
* or bucket name, or a bucket name that is not a canonical S3 name);
|
|
26
|
+
* - `ordinary-credentials-rotated`: its credentials were rotated, so the delivered ones are no
|
|
27
|
+
* longer the generation a binding adopts;
|
|
28
|
+
* - `owned-by-binding`: a credential binding or a named storage binding already owns the service
|
|
29
|
+
* capability, the resource or the bucket.
|
|
30
|
+
*/
|
|
31
|
+
export type TCorestoreLegacyResourceBlocker = 'not-adoptable' | 'ordinary-credentials-rotated' | 'owned-by-binding';
|
|
32
|
+
/**
|
|
33
|
+
* `unadopted` names what would stop the offline adoption, or `null` when nothing would;
|
|
34
|
+
* `authorized` names the binding the operator authorized, which is the only binding Corestore will
|
|
35
|
+
* let take the resource. A consumed adoption leaves no legacy resource behind, so it never appears.
|
|
36
|
+
*/
|
|
37
|
+
export type TCorestoreLegacyResourceAdoption = {
|
|
38
|
+
state: 'unadopted';
|
|
39
|
+
blocker: TCorestoreLegacyResourceBlocker | null;
|
|
40
|
+
} | {
|
|
41
|
+
state: 'authorized';
|
|
42
|
+
bindingId: string;
|
|
43
|
+
};
|
|
44
|
+
/**
|
|
45
|
+
* One legacy resource, by the identity Corestore's manifest states. A database is named by its
|
|
46
|
+
* database name, a bucket by its bucket name and its retention intent, `null` when it has none.
|
|
47
|
+
*/
|
|
48
|
+
export type TCorestoreLegacyResource = {
|
|
49
|
+
capability: 'database';
|
|
50
|
+
databaseName: string;
|
|
51
|
+
adoption: TCorestoreLegacyResourceAdoption;
|
|
52
|
+
} | {
|
|
53
|
+
capability: 'objectstorage';
|
|
54
|
+
bucketName: string;
|
|
55
|
+
retention: IObjectStorageRetentionIntent | null;
|
|
56
|
+
adoption: TCorestoreLegacyResourceAdoption;
|
|
57
|
+
};
|
|
58
|
+
/** One service's legacy resources, at most one per capability, `database` first. */
|
|
59
|
+
export interface ICorestoreLegacyServiceResources {
|
|
60
|
+
serviceId: string;
|
|
61
|
+
resources: TCorestoreLegacyResource[];
|
|
62
|
+
}
|
|
63
|
+
/** What Corestore answers on `GET /control/legacy-resources`: every service, sorted by id. */
|
|
64
|
+
export interface ICorestoreLegacyResourceInventory {
|
|
65
|
+
services: ICorestoreLegacyServiceResources[];
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* One node's legacy resources as the cluster relay read them. An unreachable node names why and
|
|
69
|
+
* lists nothing, because a silent empty list would read as a node with nothing to adopt.
|
|
70
|
+
*/
|
|
71
|
+
export type TClusterCorestoreLegacyResourceInventory = {
|
|
72
|
+
nodeId: string;
|
|
73
|
+
checkedAt: number;
|
|
74
|
+
reachable: true;
|
|
75
|
+
services: ICorestoreLegacyServiceResources[];
|
|
76
|
+
} | {
|
|
77
|
+
nodeId: string;
|
|
78
|
+
checkedAt: number;
|
|
79
|
+
reachable: false;
|
|
80
|
+
errorCode: 'CORESTORE_ENDPOINT_UNKNOWN' | 'CORESTORE_UNREACHABLE';
|
|
81
|
+
};
|
|
82
|
+
/** One resource an administrator selects for adoption. */
|
|
83
|
+
export interface ICorestoreLegacyResourceSelection {
|
|
84
|
+
serviceId: string;
|
|
85
|
+
capability: TCorestoreLegacyCapability;
|
|
86
|
+
}
|
|
87
|
+
/**
|
|
88
|
+
* One entry of Corestore's offline adoption plan, exactly the object its
|
|
89
|
+
* `legacy-resource-adoption` migration reads: the service, the capability and the binding that may
|
|
90
|
+
* adopt its legacy resource. The legacy identity is Corestore's own and is not restated here.
|
|
91
|
+
*/
|
|
92
|
+
export interface ICorestoreLegacyResourceAdoptionPlanEntry {
|
|
93
|
+
serviceId: string;
|
|
94
|
+
capability: TCorestoreLegacyCapability;
|
|
95
|
+
bindingId: string;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Why `adoptCorestoreLegacyResources` wrote nothing:
|
|
99
|
+
*
|
|
100
|
+
* - `legacy-inventory-unreachable`: the relay could not read the node's Corestore (retryable);
|
|
101
|
+
* - `legacy-inventory-changed`: the inventory no longer has `expectedInventorySha256`;
|
|
102
|
+
* - `legacy-resource-absent`: a selected service has no legacy resource of that capability;
|
|
103
|
+
* - `legacy-resource-blocked`: a selected resource is unadopted with a blocker;
|
|
104
|
+
* - `legacy-resource-authorized-elsewhere`: a selected resource is authorized for a binding Cloudly
|
|
105
|
+
* does not hold as that resource's adoption;
|
|
106
|
+
* - `service-absent`: Cloudly has no such service;
|
|
107
|
+
* - `binding-exists`: the service already has a binding of that capability that adopts nothing,
|
|
108
|
+
* or adopts another resource.
|
|
109
|
+
*/
|
|
110
|
+
export type TCorestoreLegacyAdoptionRefusal = 'legacy-inventory-unreachable' | 'legacy-inventory-changed' | 'legacy-resource-absent' | 'legacy-resource-blocked' | 'legacy-resource-authorized-elsewhere' | 'service-absent' | 'binding-exists';
|
|
111
|
+
/** The named refusal of `adoptCorestoreLegacyResources`, sent as `TypedResponseError.errorData`. */
|
|
112
|
+
export interface ICorestoreLegacyAdoptionErrorData {
|
|
113
|
+
code: TCorestoreLegacyAdoptionRefusal;
|
|
114
|
+
/** True for `legacy-inventory-unreachable` only; every other refusal needs a new read first. */
|
|
115
|
+
retryable: boolean;
|
|
116
|
+
}
|
|
117
|
+
export declare const corestoreLegacyAdoptionContract: Readonly<{
|
|
118
|
+
/** Corestore's control path for its legacy inventory, bearer-authenticated like every other. */
|
|
119
|
+
readonly inventoryPath: "/control/legacy-resources";
|
|
120
|
+
/** Corestore's own plan bound, which also bounds a selection and an inventory. */
|
|
121
|
+
readonly maximumPlanEntries: 4096;
|
|
122
|
+
readonly maximumServices: 4096;
|
|
123
|
+
readonly maximumNameLength: 255;
|
|
124
|
+
readonly digestDomain: "serve.zone/corestore-legacy-resources";
|
|
125
|
+
}>;
|
|
126
|
+
/** Validates Corestore's answer on its legacy inventory path and names every reason it is refused. */
|
|
127
|
+
export declare const validateCorestoreLegacyResourceInventory: (valueArg: unknown, pathArg?: string) => string[];
|
|
128
|
+
/** Validates one node's legacy inventory as the relay reports it. Shape only. */
|
|
129
|
+
export declare const validateClusterCorestoreLegacyResourceInventory: (valueArg: unknown, pathArg?: string) => string[];
|
|
130
|
+
/**
|
|
131
|
+
* The digest an adoption is checked against: the node and its services, not the read time, so two
|
|
132
|
+
* reads of an unchanged Corestore agree. Throws for an invalid or unreachable inventory.
|
|
133
|
+
*/
|
|
134
|
+
export declare const computeClusterCorestoreLegacyResourceInventorySha256: (inventoryArg: TClusterCorestoreLegacyResourceInventory) => Promise<string>;
|
|
135
|
+
/** Validates an administrator's selection: 1..4096 exact entries, sorted by service then capability. */
|
|
136
|
+
export declare const validateCorestoreLegacyResourceSelections: (valueArg: unknown, pathArg?: string) => string[];
|
|
137
|
+
/**
|
|
138
|
+
* Validates an adoption plan by the rules Corestore's migration applies: a non-empty array of at
|
|
139
|
+
* most 4096 exact `{ serviceId, capability, bindingId }` entries, canonical identifiers, and no
|
|
140
|
+
* service capability or binding id twice. Order is free.
|
|
141
|
+
*/
|
|
142
|
+
export declare const validateCorestoreLegacyResourceAdoptionPlan: (valueArg: unknown, pathArg?: string) => string[];
|
|
143
|
+
/** The binding fields an adoption judges; a full `IPlatformBinding` satisfies it. */
|
|
144
|
+
export interface ICorestoreLegacyAdoptionBindingView {
|
|
145
|
+
id: string;
|
|
146
|
+
serviceId: string;
|
|
147
|
+
capability: string;
|
|
148
|
+
objectstorageBucketName?: string;
|
|
149
|
+
objectstorageRetention?: {
|
|
150
|
+
intent: IObjectStorageRetentionIntent;
|
|
151
|
+
};
|
|
152
|
+
corestoreLegacyAdoption?: {
|
|
153
|
+
nodeId: string;
|
|
154
|
+
resourceName: string;
|
|
155
|
+
inventorySha256: string;
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Content check of one adopting binding against the inventory it was adopted at, and the one rule
|
|
160
|
+
* that lets a binding carry a legacy bucket name: the binding names this node, this inventory
|
|
161
|
+
* digest and the legacy resource's name; the resource is unadopted without a blocker or authorized
|
|
162
|
+
* for exactly this binding; an adopted bucket's `objectstorageBucketName` is the legacy bucket and
|
|
163
|
+
* its retention intent the legacy intent exactly, absent when the legacy bucket has none; a
|
|
164
|
+
* database binding carries neither. Whether the digest is current is the caller's to check.
|
|
165
|
+
*/
|
|
166
|
+
export declare const validatePlatformBindingCorestoreLegacyAdoption: (bindingArg: ICorestoreLegacyAdoptionBindingView, inventoryArg: TClusterCorestoreLegacyResourceInventory, inventorySha256Arg: string, pathArg?: string) => string[];
|
|
167
|
+
/**
|
|
168
|
+
* The plan for every adopting binding, sorted by service then capability, in the exact entry shape
|
|
169
|
+
* Corestore's migration reads. Throws unless every binding adopts a legacy resource and the result
|
|
170
|
+
* is a valid plan.
|
|
171
|
+
*/
|
|
172
|
+
export declare const createCorestoreLegacyResourceAdoptionPlan: (bindingsArg: readonly ICorestoreLegacyAdoptionBindingView[]) => ICorestoreLegacyResourceAdoptionPlanEntry[];
|
|
173
|
+
/**
|
|
174
|
+
* The binding status reason a Corestore control answer names: a 409 whose body is
|
|
175
|
+
* `{ ok: false, error, code }` with `code` one of the legacy adoption reasons. Every other answer,
|
|
176
|
+
* including a 409 with another code, names none and keeps its ordinary failure handling.
|
|
177
|
+
*/
|
|
178
|
+
export declare const readCorestoreLegacyAdoptionRefusal: (statusCodeArg: number, bodyArg: unknown) => TPlatformBindingStatusReason | null;
|
|
@@ -0,0 +1,289 @@
|
|
|
1
|
+
import { objectStorageRetentionIntentsEqual, validateObjectStorageRetentionIntent, } from '../platform/objectstorageretention.js';
|
|
2
|
+
import { validatePlatformObjectStorageBucketName } from '../platform/objectstorage.js';
|
|
3
|
+
import { platformBindingStatusReasons } from '../platform/types.js';
|
|
4
|
+
import { canonicalizeStrictJson, compareWireTokens, createCanonicalJsonSha256Hex, } from '../private/canonicaljson.js';
|
|
5
|
+
import { hasExactKeys, isPlainRecord } from '../private/dataproperties.js';
|
|
6
|
+
import { isClusterNodeId } from '../private/nodeidentifier.js';
|
|
7
|
+
export const corestoreLegacyAdoptionContract = Object.freeze({
|
|
8
|
+
/** Corestore's control path for its legacy inventory, bearer-authenticated like every other. */
|
|
9
|
+
inventoryPath: '/control/legacy-resources',
|
|
10
|
+
/** Corestore's own plan bound, which also bounds a selection and an inventory. */
|
|
11
|
+
maximumPlanEntries: 4096,
|
|
12
|
+
maximumServices: 4096,
|
|
13
|
+
maximumNameLength: 255,
|
|
14
|
+
digestDomain: 'serve.zone/corestore-legacy-resources',
|
|
15
|
+
});
|
|
16
|
+
const identifierPattern = /^[A-Za-z0-9][A-Za-z0-9:._-]{0,199}$/;
|
|
17
|
+
const printableNamePattern = /^[\x21-\x7e]+$/;
|
|
18
|
+
const bareSha256Pattern = /^[a-f0-9]{64}$/;
|
|
19
|
+
const blockers = [
|
|
20
|
+
'not-adoptable', 'ordinary-credentials-rotated', 'owned-by-binding',
|
|
21
|
+
];
|
|
22
|
+
const isIdentifier = (valueArg) => (typeof valueArg === 'string' && identifierPattern.test(valueArg));
|
|
23
|
+
const isLegacyName = (valueArg) => (typeof valueArg === 'string'
|
|
24
|
+
&& valueArg.length <= corestoreLegacyAdoptionContract.maximumNameLength
|
|
25
|
+
&& printableNamePattern.test(valueArg));
|
|
26
|
+
const isCapability = (valueArg) => (valueArg === 'database' || valueArg === 'objectstorage');
|
|
27
|
+
const validateAdoption = (valueArg, pathArg) => {
|
|
28
|
+
if (!isPlainRecord(valueArg))
|
|
29
|
+
return [`${pathArg} must use its exact schema`];
|
|
30
|
+
if (valueArg.state === 'unadopted') {
|
|
31
|
+
if (!hasExactKeys(valueArg, ['state', 'blocker']))
|
|
32
|
+
return [`${pathArg} must use its exact schema`];
|
|
33
|
+
return valueArg.blocker === null || blockers.includes(valueArg.blocker)
|
|
34
|
+
? []
|
|
35
|
+
: [`${pathArg} blocker must be null or a named blocker`];
|
|
36
|
+
}
|
|
37
|
+
if (valueArg.state === 'authorized') {
|
|
38
|
+
if (!hasExactKeys(valueArg, ['state', 'bindingId']))
|
|
39
|
+
return [`${pathArg} must use its exact schema`];
|
|
40
|
+
return isIdentifier(valueArg.bindingId) ? [] : [`${pathArg} bindingId must be a canonical identifier`];
|
|
41
|
+
}
|
|
42
|
+
return [`${pathArg} state must be unadopted or authorized`];
|
|
43
|
+
};
|
|
44
|
+
/** An adoptable resource is one the offline adoption could authorize or already did. */
|
|
45
|
+
const isAdoptable = (adoptionArg) => (isPlainRecord(adoptionArg) && (adoptionArg.state === 'authorized' || adoptionArg.blocker === null));
|
|
46
|
+
const validateResource = (valueArg, pathArg) => {
|
|
47
|
+
if (!isPlainRecord(valueArg))
|
|
48
|
+
return [`${pathArg} must use its exact schema`];
|
|
49
|
+
if (valueArg.capability === 'database') {
|
|
50
|
+
if (!hasExactKeys(valueArg, ['capability', 'databaseName', 'adoption'])) {
|
|
51
|
+
return [`${pathArg} must use its exact schema`];
|
|
52
|
+
}
|
|
53
|
+
const errors = validateAdoption(valueArg.adoption, `${pathArg} adoption`);
|
|
54
|
+
if (!isLegacyName(valueArg.databaseName))
|
|
55
|
+
errors.push(`${pathArg} databaseName must be a bounded printable name`);
|
|
56
|
+
return errors;
|
|
57
|
+
}
|
|
58
|
+
if (valueArg.capability === 'objectstorage') {
|
|
59
|
+
if (!hasExactKeys(valueArg, ['capability', 'bucketName', 'retention', 'adoption'])) {
|
|
60
|
+
return [`${pathArg} must use its exact schema`];
|
|
61
|
+
}
|
|
62
|
+
const errors = validateAdoption(valueArg.adoption, `${pathArg} adoption`);
|
|
63
|
+
if (!isLegacyName(valueArg.bucketName)) {
|
|
64
|
+
errors.push(`${pathArg} bucketName must be a bounded printable name`);
|
|
65
|
+
}
|
|
66
|
+
else if (errors.length === 0 && isAdoptable(valueArg.adoption)) {
|
|
67
|
+
// A binding request carries only a canonical bucket, so an adoptable bucket has to be one.
|
|
68
|
+
errors.push(...validatePlatformObjectStorageBucketName(valueArg.bucketName, `${pathArg} bucketName`));
|
|
69
|
+
}
|
|
70
|
+
if (valueArg.retention !== null) {
|
|
71
|
+
errors.push(...validateObjectStorageRetentionIntent(valueArg.retention, `${pathArg} retention`));
|
|
72
|
+
}
|
|
73
|
+
return errors;
|
|
74
|
+
}
|
|
75
|
+
return [`${pathArg} capability must be database or objectstorage`];
|
|
76
|
+
};
|
|
77
|
+
const validateServices = (valueArg, pathArg) => {
|
|
78
|
+
if (!Array.isArray(valueArg) || valueArg.length > corestoreLegacyAdoptionContract.maximumServices) {
|
|
79
|
+
return [`${pathArg} must be a bounded array`];
|
|
80
|
+
}
|
|
81
|
+
const errors = [];
|
|
82
|
+
let previousServiceId;
|
|
83
|
+
for (const [index, service] of valueArg.entries()) {
|
|
84
|
+
const servicePath = `${pathArg}[${index}]`;
|
|
85
|
+
if (!isPlainRecord(service) || !hasExactKeys(service, ['serviceId', 'resources'])) {
|
|
86
|
+
errors.push(`${servicePath} must use its exact schema`);
|
|
87
|
+
continue;
|
|
88
|
+
}
|
|
89
|
+
if (!isIdentifier(service.serviceId)) {
|
|
90
|
+
errors.push(`${servicePath} serviceId must be a canonical identifier`);
|
|
91
|
+
}
|
|
92
|
+
else {
|
|
93
|
+
if (previousServiceId !== undefined && compareWireTokens(previousServiceId, service.serviceId) >= 0) {
|
|
94
|
+
errors.push(`${pathArg} must be sorted by serviceId without repeats`);
|
|
95
|
+
}
|
|
96
|
+
previousServiceId = service.serviceId;
|
|
97
|
+
}
|
|
98
|
+
if (!Array.isArray(service.resources) || service.resources.length < 1 || service.resources.length > 2) {
|
|
99
|
+
errors.push(`${servicePath} resources must list one or two resources`);
|
|
100
|
+
continue;
|
|
101
|
+
}
|
|
102
|
+
for (const [resourceIndex, resource] of service.resources.entries()) {
|
|
103
|
+
errors.push(...validateResource(resource, `${servicePath} resources[${resourceIndex}]`));
|
|
104
|
+
}
|
|
105
|
+
if (service.resources.length === 2
|
|
106
|
+
&& !(isPlainRecord(service.resources[0]) && service.resources[0].capability === 'database'
|
|
107
|
+
&& isPlainRecord(service.resources[1]) && service.resources[1].capability === 'objectstorage')) {
|
|
108
|
+
errors.push(`${servicePath} resources must hold one database before one objectstorage resource`);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
return errors;
|
|
112
|
+
};
|
|
113
|
+
/** Validates Corestore's answer on its legacy inventory path and names every reason it is refused. */
|
|
114
|
+
export const validateCorestoreLegacyResourceInventory = (valueArg, pathArg = 'corestore legacy resource inventory') => {
|
|
115
|
+
if (!isPlainRecord(valueArg) || !hasExactKeys(valueArg, ['services'])) {
|
|
116
|
+
return [`${pathArg} must use its exact schema`];
|
|
117
|
+
}
|
|
118
|
+
return validateServices(valueArg.services, `${pathArg} services`);
|
|
119
|
+
};
|
|
120
|
+
/** Validates one node's legacy inventory as the relay reports it. Shape only. */
|
|
121
|
+
export const validateClusterCorestoreLegacyResourceInventory = (valueArg, pathArg = 'cluster corestore legacy resource inventory') => {
|
|
122
|
+
if (!isPlainRecord(valueArg))
|
|
123
|
+
return [`${pathArg} must use its exact schema`];
|
|
124
|
+
const reachable = valueArg.reachable;
|
|
125
|
+
if (reachable === true
|
|
126
|
+
? !hasExactKeys(valueArg, ['nodeId', 'checkedAt', 'reachable', 'services'])
|
|
127
|
+
: reachable !== false || !hasExactKeys(valueArg, ['nodeId', 'checkedAt', 'reachable', 'errorCode'])) {
|
|
128
|
+
return [`${pathArg} must use its exact schema`];
|
|
129
|
+
}
|
|
130
|
+
const errors = [];
|
|
131
|
+
if (!isClusterNodeId(valueArg.nodeId))
|
|
132
|
+
errors.push(`${pathArg} nodeId must be a node id`);
|
|
133
|
+
if (!Number.isSafeInteger(valueArg.checkedAt) || valueArg.checkedAt < 0) {
|
|
134
|
+
errors.push(`${pathArg} checkedAt must be a non-negative safe integer`);
|
|
135
|
+
}
|
|
136
|
+
if (reachable === true) {
|
|
137
|
+
errors.push(...validateServices(valueArg.services, `${pathArg} services`));
|
|
138
|
+
}
|
|
139
|
+
else if (valueArg.errorCode !== 'CORESTORE_ENDPOINT_UNKNOWN' && valueArg.errorCode !== 'CORESTORE_UNREACHABLE') {
|
|
140
|
+
errors.push(`${pathArg} errorCode must name why the node could not be read`);
|
|
141
|
+
}
|
|
142
|
+
return errors;
|
|
143
|
+
};
|
|
144
|
+
const failDigest = (reasonArg) => {
|
|
145
|
+
throw new Error(reasonArg);
|
|
146
|
+
};
|
|
147
|
+
/**
|
|
148
|
+
* The digest an adoption is checked against: the node and its services, not the read time, so two
|
|
149
|
+
* reads of an unchanged Corestore agree. Throws for an invalid or unreachable inventory.
|
|
150
|
+
*/
|
|
151
|
+
export const computeClusterCorestoreLegacyResourceInventorySha256 = async (inventoryArg) => {
|
|
152
|
+
const errors = validateClusterCorestoreLegacyResourceInventory(inventoryArg);
|
|
153
|
+
if (errors.length > 0)
|
|
154
|
+
throw new Error(errors[0]);
|
|
155
|
+
if (inventoryArg.reachable !== true)
|
|
156
|
+
throw new Error('an unreachable legacy inventory has no digest');
|
|
157
|
+
return createCanonicalJsonSha256Hex(canonicalizeStrictJson({
|
|
158
|
+
domain: corestoreLegacyAdoptionContract.digestDomain,
|
|
159
|
+
nodeId: inventoryArg.nodeId,
|
|
160
|
+
services: inventoryArg.services,
|
|
161
|
+
}, failDigest, 'corestore legacy resource inventory'), failDigest);
|
|
162
|
+
};
|
|
163
|
+
const selectionKey = (entryArg) => `${entryArg.serviceId}\u0000${entryArg.capability}`;
|
|
164
|
+
/** Validates an administrator's selection: 1..4096 exact entries, sorted by service then capability. */
|
|
165
|
+
export const validateCorestoreLegacyResourceSelections = (valueArg, pathArg = 'corestore legacy resource selection') => {
|
|
166
|
+
if (!Array.isArray(valueArg) || valueArg.length < 1
|
|
167
|
+
|| valueArg.length > corestoreLegacyAdoptionContract.maximumPlanEntries) {
|
|
168
|
+
return [`${pathArg} must be a non-empty bounded array`];
|
|
169
|
+
}
|
|
170
|
+
const errors = [];
|
|
171
|
+
let previous;
|
|
172
|
+
for (const [index, entry] of valueArg.entries()) {
|
|
173
|
+
if (!isPlainRecord(entry) || !hasExactKeys(entry, ['serviceId', 'capability'])
|
|
174
|
+
|| !isIdentifier(entry.serviceId) || !isCapability(entry.capability)) {
|
|
175
|
+
errors.push(`${pathArg}[${index}] must be an exact { serviceId, capability }`);
|
|
176
|
+
continue;
|
|
177
|
+
}
|
|
178
|
+
const key = selectionKey(entry);
|
|
179
|
+
if (previous !== undefined && compareWireTokens(previous, key) >= 0) {
|
|
180
|
+
errors.push(`${pathArg} must be sorted by serviceId then capability without repeats`);
|
|
181
|
+
}
|
|
182
|
+
previous = key;
|
|
183
|
+
}
|
|
184
|
+
return errors;
|
|
185
|
+
};
|
|
186
|
+
/**
|
|
187
|
+
* Validates an adoption plan by the rules Corestore's migration applies: a non-empty array of at
|
|
188
|
+
* most 4096 exact `{ serviceId, capability, bindingId }` entries, canonical identifiers, and no
|
|
189
|
+
* service capability or binding id twice. Order is free.
|
|
190
|
+
*/
|
|
191
|
+
export const validateCorestoreLegacyResourceAdoptionPlan = (valueArg, pathArg = 'adoption plan') => {
|
|
192
|
+
if (!Array.isArray(valueArg) || valueArg.length === 0
|
|
193
|
+
|| valueArg.length > corestoreLegacyAdoptionContract.maximumPlanEntries) {
|
|
194
|
+
return [`${pathArg} must be a non-empty bounded array`];
|
|
195
|
+
}
|
|
196
|
+
const errors = [];
|
|
197
|
+
const serviceCapabilities = new Set();
|
|
198
|
+
const bindingIds = new Set();
|
|
199
|
+
for (const [index, entry] of valueArg.entries()) {
|
|
200
|
+
if (!isPlainRecord(entry) || !hasExactKeys(entry, ['serviceId', 'capability', 'bindingId'])
|
|
201
|
+
|| !isIdentifier(entry.serviceId) || !isIdentifier(entry.bindingId) || !isCapability(entry.capability)) {
|
|
202
|
+
errors.push(`${pathArg} entry ${index} must be an exact { serviceId, capability, bindingId }`);
|
|
203
|
+
continue;
|
|
204
|
+
}
|
|
205
|
+
const serviceCapability = selectionKey(entry);
|
|
206
|
+
if (serviceCapabilities.has(serviceCapability) || bindingIds.has(entry.bindingId)) {
|
|
207
|
+
errors.push(`${pathArg} entry ${index} repeats a service capability or binding id`);
|
|
208
|
+
}
|
|
209
|
+
serviceCapabilities.add(serviceCapability);
|
|
210
|
+
bindingIds.add(entry.bindingId);
|
|
211
|
+
}
|
|
212
|
+
return errors;
|
|
213
|
+
};
|
|
214
|
+
/**
|
|
215
|
+
* Content check of one adopting binding against the inventory it was adopted at, and the one rule
|
|
216
|
+
* that lets a binding carry a legacy bucket name: the binding names this node, this inventory
|
|
217
|
+
* digest and the legacy resource's name; the resource is unadopted without a blocker or authorized
|
|
218
|
+
* for exactly this binding; an adopted bucket's `objectstorageBucketName` is the legacy bucket and
|
|
219
|
+
* its retention intent the legacy intent exactly, absent when the legacy bucket has none; a
|
|
220
|
+
* database binding carries neither. Whether the digest is current is the caller's to check.
|
|
221
|
+
*/
|
|
222
|
+
export const validatePlatformBindingCorestoreLegacyAdoption = (bindingArg, inventoryArg, inventorySha256Arg, pathArg = 'platform binding corestoreLegacyAdoption') => {
|
|
223
|
+
if (validateClusterCorestoreLegacyResourceInventory(inventoryArg).length > 0 || inventoryArg.reachable !== true
|
|
224
|
+
|| typeof inventorySha256Arg !== 'string' || !bareSha256Pattern.test(inventorySha256Arg)) {
|
|
225
|
+
return [`${pathArg} needs a valid reachable inventory and its digest`];
|
|
226
|
+
}
|
|
227
|
+
const adoption = bindingArg.corestoreLegacyAdoption;
|
|
228
|
+
if (!isPlainRecord(adoption) || !hasExactKeys(adoption, ['nodeId', 'resourceName', 'inventorySha256'])) {
|
|
229
|
+
return [`${pathArg} must use its exact schema`];
|
|
230
|
+
}
|
|
231
|
+
if (adoption.nodeId !== inventoryArg.nodeId || adoption.inventorySha256 !== inventorySha256Arg) {
|
|
232
|
+
return [`${pathArg} must name the inventory's node and digest`];
|
|
233
|
+
}
|
|
234
|
+
if (!isCapability(bindingArg.capability))
|
|
235
|
+
return [`${pathArg} needs a database or objectstorage binding`];
|
|
236
|
+
const resource = inventoryArg.services.find((serviceArg) => serviceArg.serviceId === bindingArg.serviceId)
|
|
237
|
+
?.resources.find((resourceArg) => resourceArg.capability === bindingArg.capability);
|
|
238
|
+
if (!resource)
|
|
239
|
+
return [`${pathArg} names no legacy resource of the service and capability`];
|
|
240
|
+
const errors = [];
|
|
241
|
+
const legacyName = resource.capability === 'database' ? resource.databaseName : resource.bucketName;
|
|
242
|
+
if (adoption.resourceName !== legacyName)
|
|
243
|
+
errors.push(`${pathArg} resourceName must be the legacy resource's name`);
|
|
244
|
+
if (resource.adoption.state === 'unadopted' ? resource.adoption.blocker !== null
|
|
245
|
+
: resource.adoption.bindingId !== bindingArg.id) {
|
|
246
|
+
errors.push(`${pathArg} names a resource that is blocked or authorized for another binding`);
|
|
247
|
+
}
|
|
248
|
+
if (resource.capability === 'objectstorage') {
|
|
249
|
+
if (bindingArg.objectstorageBucketName !== resource.bucketName) {
|
|
250
|
+
errors.push(`${pathArg} objectstorageBucketName must be the legacy bucket`);
|
|
251
|
+
}
|
|
252
|
+
if (resource.retention === null
|
|
253
|
+
? bindingArg.objectstorageRetention !== undefined
|
|
254
|
+
: !objectStorageRetentionIntentsEqual(bindingArg.objectstorageRetention?.intent, resource.retention)) {
|
|
255
|
+
errors.push(`${pathArg} retention intent must be the legacy bucket's exactly`);
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
else if (bindingArg.objectstorageBucketName !== undefined || bindingArg.objectstorageRetention !== undefined) {
|
|
259
|
+
errors.push(`${pathArg} database binding must carry no bucket or retention`);
|
|
260
|
+
}
|
|
261
|
+
return errors;
|
|
262
|
+
};
|
|
263
|
+
/**
|
|
264
|
+
* The plan for every adopting binding, sorted by service then capability, in the exact entry shape
|
|
265
|
+
* Corestore's migration reads. Throws unless every binding adopts a legacy resource and the result
|
|
266
|
+
* is a valid plan.
|
|
267
|
+
*/
|
|
268
|
+
export const createCorestoreLegacyResourceAdoptionPlan = (bindingsArg) => {
|
|
269
|
+
const plan = bindingsArg.map((bindingArg) => {
|
|
270
|
+
if (bindingArg.corestoreLegacyAdoption === undefined || !isCapability(bindingArg.capability)) {
|
|
271
|
+
throw new Error(`binding ${bindingArg.id} adopts no legacy Corestore resource`);
|
|
272
|
+
}
|
|
273
|
+
return { serviceId: bindingArg.serviceId, capability: bindingArg.capability, bindingId: bindingArg.id };
|
|
274
|
+
}).sort((leftArg, rightArg) => compareWireTokens(selectionKey(leftArg), selectionKey(rightArg)));
|
|
275
|
+
const errors = validateCorestoreLegacyResourceAdoptionPlan(plan);
|
|
276
|
+
if (errors.length > 0)
|
|
277
|
+
throw new Error(errors[0]);
|
|
278
|
+
return plan;
|
|
279
|
+
};
|
|
280
|
+
/**
|
|
281
|
+
* The binding status reason a Corestore control answer names: a 409 whose body is
|
|
282
|
+
* `{ ok: false, error, code }` with `code` one of the legacy adoption reasons. Every other answer,
|
|
283
|
+
* including a 409 with another code, names none and keeps its ordinary failure handling.
|
|
284
|
+
*/
|
|
285
|
+
export const readCorestoreLegacyAdoptionRefusal = (statusCodeArg, bodyArg) => (statusCodeArg === 409 && isPlainRecord(bodyArg) && bodyArg.ok === false
|
|
286
|
+
&& platformBindingStatusReasons.includes(bodyArg.code)
|
|
287
|
+
? bodyArg.code
|
|
288
|
+
: null);
|
|
289
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29yZXN0b3JlbGVnYWN5YWRvcHRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9kYXRhL2NvcmVzdG9yZWxlZ2FjeWFkb3B0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFDTCxrQ0FBa0MsRUFDbEMsb0NBQW9DLEdBQ3JDLE1BQU0sdUNBQXVDLENBQUM7QUFDL0MsT0FBTyxFQUFFLHVDQUF1QyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFdkYsT0FBTyxFQUFFLDRCQUE0QixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDcEUsT0FBTyxFQUNMLHNCQUFzQixFQUN0QixpQkFBaUIsRUFDakIsNEJBQTRCLEdBQzdCLE1BQU0sNkJBQTZCLENBQUM7QUFDckMsT0FBTyxFQUFFLFlBQVksRUFBRSxhQUFhLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUMzRSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFpSS9ELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUM7SUFDM0QsZ0dBQWdHO0lBQ2hHLGFBQWEsRUFBRSwyQkFBMkI7SUFDMUMsa0ZBQWtGO0lBQ2xGLGtCQUFrQixFQUFFLElBQUk7SUFDeEIsZUFBZSxFQUFFLElBQUk7SUFDckIsaUJBQWlCLEVBQUUsR0FBRztJQUN0QixZQUFZLEVBQUUsdUNBQXVDO0NBQzdDLENBQUMsQ0FBQztBQUVaLE1BQU0saUJBQWlCLEdBQUcscUNBQXFDLENBQUM7QUFDaEUsTUFBTSxvQkFBb0IsR0FBRyxnQkFBZ0IsQ0FBQztBQUM5QyxNQUFNLGlCQUFpQixHQUFHLGdCQUFnQixDQUFDO0FBQzNDLE1BQU0sUUFBUSxHQUErQztJQUMzRCxlQUFlLEVBQUUsOEJBQThCLEVBQUUsa0JBQWtCO0NBQ3BFLENBQUM7QUFFRixNQUFNLFlBQVksR0FBRyxDQUFDLFFBQWlCLEVBQXNCLEVBQUUsQ0FBQyxDQUM5RCxPQUFPLFFB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
|
package/dist_ts/data/index.d.ts
CHANGED
|
@@ -3,9 +3,11 @@ export * from './cluster.js';
|
|
|
3
3
|
export * from './clusterruntime.js';
|
|
4
4
|
export * from './clustervpn.js';
|
|
5
5
|
export * from './clusteringress.js';
|
|
6
|
+
export * from './clusteringressdesignation.js';
|
|
6
7
|
export * from './clusterrelaycredential.js';
|
|
7
8
|
export * from './config.js';
|
|
8
9
|
export * from './corestore.js';
|
|
10
|
+
export * from './corestorelegacyadoption.js';
|
|
9
11
|
export * from './coremail.js';
|
|
10
12
|
export * from './coremail.runtime.js';
|
|
11
13
|
export * from './deployment.js';
|
|
@@ -40,6 +42,8 @@ export * from './networkprojection.js';
|
|
|
40
42
|
export type { IRuntimeNetworkRouterPacketGrant, IRuntimeNetworkRouterProjection } from './networkrouter.js';
|
|
41
43
|
export type { IRuntimeNetworkHostIngress, IRuntimeNetworkHostPacketGrant, IRuntimeNetworkHostProjection } from './networkhost.js';
|
|
42
44
|
export { runtimeNetworkHostContract } from './networkhost.js';
|
|
45
|
+
export type { IRuntimeNetworkWorkloadIngress, IRuntimeNetworkWorkloadIngressPacketGrant, IRuntimeNetworkWorkloadIngressProjection } from './networkworkloadingress.js';
|
|
46
|
+
export { runtimeNetworkWorkloadIngressContract } from './networkworkloadingress.js';
|
|
43
47
|
export * from './networkprotection.js';
|
|
44
48
|
export * from './networksigning.js';
|
|
45
49
|
export * from './privatenetwork.js';
|
|
@@ -48,6 +52,7 @@ export * from './releaseversion.js';
|
|
|
48
52
|
export * from './runtimeassignment.js';
|
|
49
53
|
export * from './runtimeconfig.js';
|
|
50
54
|
export * from './runtimestorageclaim.js';
|
|
55
|
+
export * from './runtimelocalstorageclaim.js';
|
|
51
56
|
export * from './runtimesession.js';
|
|
52
57
|
export * from './runtimeterminalreceipt.js';
|
|
53
58
|
export * from './secret.js';
|
|
@@ -62,6 +67,7 @@ export * from './service.js';
|
|
|
62
67
|
export * from './servicecredential.js';
|
|
63
68
|
export * from './serviceports.js';
|
|
64
69
|
export * from './serviceruntime.js';
|
|
70
|
+
export * from './servicevolumeinitialization.js';
|
|
65
71
|
export * from './status.js';
|
|
66
72
|
export * from './taskexecution.js';
|
|
67
73
|
export * from './traffic.js';
|
package/dist_ts/data/index.js
CHANGED
|
@@ -3,9 +3,11 @@ export * from './cluster.js';
|
|
|
3
3
|
export * from './clusterruntime.js';
|
|
4
4
|
export * from './clustervpn.js';
|
|
5
5
|
export * from './clusteringress.js';
|
|
6
|
+
export * from './clusteringressdesignation.js';
|
|
6
7
|
export * from './clusterrelaycredential.js';
|
|
7
8
|
export * from './config.js';
|
|
8
9
|
export * from './corestore.js';
|
|
10
|
+
export * from './corestorelegacyadoption.js';
|
|
9
11
|
export * from './coremail.js';
|
|
10
12
|
export * from './coremail.runtime.js';
|
|
11
13
|
export * from './deployment.js';
|
|
@@ -38,6 +40,7 @@ export * from './networklease.js';
|
|
|
38
40
|
export * from './networknode.js';
|
|
39
41
|
export * from './networkprojection.js';
|
|
40
42
|
export { runtimeNetworkHostContract } from './networkhost.js';
|
|
43
|
+
export { runtimeNetworkWorkloadIngressContract } from './networkworkloadingress.js';
|
|
41
44
|
export * from './networkprotection.js';
|
|
42
45
|
export * from './networksigning.js';
|
|
43
46
|
export * from './privatenetwork.js';
|
|
@@ -46,6 +49,7 @@ export * from './releaseversion.js';
|
|
|
46
49
|
export * from './runtimeassignment.js';
|
|
47
50
|
export * from './runtimeconfig.js';
|
|
48
51
|
export * from './runtimestorageclaim.js';
|
|
52
|
+
export * from './runtimelocalstorageclaim.js';
|
|
49
53
|
export * from './runtimesession.js';
|
|
50
54
|
export * from './runtimeterminalreceipt.js';
|
|
51
55
|
export * from './secret.js';
|
|
@@ -60,10 +64,11 @@ export * from './service.js';
|
|
|
60
64
|
export * from './servicecredential.js';
|
|
61
65
|
export * from './serviceports.js';
|
|
62
66
|
export * from './serviceruntime.js';
|
|
67
|
+
export * from './servicevolumeinitialization.js';
|
|
63
68
|
export * from './status.js';
|
|
64
69
|
export * from './taskexecution.js';
|
|
65
70
|
export * from './traffic.js';
|
|
66
71
|
export * from './user.js';
|
|
67
72
|
export * from './version.js';
|
|
68
73
|
export * from './webpush.js';
|
|
69
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
74
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9kYXRhL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxnQ0FBZ0MsQ0FBQztBQUMvQyxjQUFjLDZCQUE2QixDQUFDO0FBQzVDLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZ0JBQWdCLENBQUM7QUFDL0IsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLGVBQWUsQ0FBQztBQUM5QixjQUFjLHVCQUF1QixDQUFDO0FBQ3RDLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLFVBQVUsQ0FBQztBQUN6QixjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLHVCQUF1QixDQUFDO0FBQ3RDLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLFdBQVcsQ0FBQztBQUMxQixjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsc0JBQXNCLENBQUM7QUFDckMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMsd0JBQXdCLENBQUM7QUFHdkMsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFHOUQsT0FBTyxFQUFFLHFDQUFxQyxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDcEYsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxlQUFlLENBQUM7QUFDOUIsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsb0JBQW9CLENBQUM7QUFDbkMsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyw2QkFBNkIsQ0FBQztBQUM1QyxjQUFjLGFBQWEsQ0FBQztBQUM1QixjQUFjLGdCQUFnQixDQUFDO0FBQy9CLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYyxlQUFlLENBQUM7QUFDOUIsY0FBYyw0QkFBNEIsQ0FBQztBQUMzQyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsd0JBQXdCLENBQUM7QUFDdkMsY0FBYyxtQkFBbUIsQ0FBQztBQUNsQyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsa0NBQWtDLENBQUM7QUFDakQsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLFdBQVcsQ0FBQztBQUMxQixjQUFjLGNBQWMsQ0FBQztBQUM3QixjQUFjLGNBQWMsQ0FBQyJ9
|
|
@@ -4,6 +4,7 @@ import type { IRuntimeNetworkHandoffLease, IRuntimeNetworkProtectedAuthority } f
|
|
|
4
4
|
import type { IPrivateNetwork, IServicePrivateNetworks, IServicePrivateNetworkDnsPolicy } from './privatenetwork.js';
|
|
5
5
|
import { type IRuntimeNetworkRouterPacketGrant, type IRuntimeNetworkRouterProjection } from './networkrouter.js';
|
|
6
6
|
import { type IRuntimeNetworkHostPacketGrant, type IRuntimeNetworkHostProjection } from './networkhost.js';
|
|
7
|
+
import { type IRuntimeNetworkWorkloadIngressPacketGrant, type IRuntimeNetworkWorkloadIngressProjection } from './networkworkloadingress.js';
|
|
7
8
|
export interface IRuntimeNetworkNodeScope {
|
|
8
9
|
controller: IRuntimeController;
|
|
9
10
|
nodeId: string;
|
|
@@ -154,6 +155,21 @@ export interface IRuntimeNetworkProjection extends IRuntimeNetworkNodeScope {
|
|
|
154
155
|
* host-origin flow; any other controller kind carrying it is refused.
|
|
155
156
|
*/
|
|
156
157
|
host?: IRuntimeNetworkHostProjection;
|
|
158
|
+
/**
|
|
159
|
+
* One-way workload ingress selections of a `cloudly` projection: the cluster ingress workload dials
|
|
160
|
+
* exact target workload ports across organizations (`IRuntimeNetworkWorkloadIngressPacketGrant`).
|
|
161
|
+
* Omitted, it keeps the canonical bytes and grants no such flow; any other controller kind
|
|
162
|
+
* carrying it is refused.
|
|
163
|
+
*/
|
|
164
|
+
workloadIngress?: IRuntimeNetworkWorkloadIngressProjection;
|
|
165
|
+
/**
|
|
166
|
+
* Ids of the protected authority's platform endpoints whose address this projection's node's own
|
|
167
|
+
* host carries, such as a relay listener or a Corestore beside the node on one machine. The node
|
|
168
|
+
* delivers workload flows to them locally instead of forwarding them. Sorted, unique and never
|
|
169
|
+
* empty when present; omitted, it keeps the canonical bytes and states that no endpoint is local.
|
|
170
|
+
* It grants nothing: a workload still reaches only the endpoints it selects.
|
|
171
|
+
*/
|
|
172
|
+
hostPlatformEndpointIds?: string[];
|
|
157
173
|
digest: TSha256Digest;
|
|
158
174
|
}
|
|
159
175
|
export interface IRuntimeNetworkDnsView {
|
|
@@ -203,6 +219,8 @@ export declare const getRuntimeNetworkProjectionPacketGrants: (value: unknown) =
|
|
|
203
219
|
export declare const getRuntimeNetworkProjectionRouterPacketGrants: (value: unknown) => Promise<IRuntimeNetworkRouterPacketGrant[]>;
|
|
204
220
|
/** Host-origin authority comes only from explicit signed `onebox` selections of local workload ports. */
|
|
205
221
|
export declare const getRuntimeNetworkProjectionHostPacketGrants: (value: unknown) => Promise<IRuntimeNetworkHostPacketGrant[]>;
|
|
222
|
+
/** One-way workload ingress authority comes only from explicit signed `cloudly` selections of exact target ports. */
|
|
223
|
+
export declare const getRuntimeNetworkProjectionWorkloadIngressPacketGrants: (value: unknown) => Promise<IRuntimeNetworkWorkloadIngressPacketGrant[]>;
|
|
206
224
|
/** Complete offline DNS material, including authorized names never previously queried. */
|
|
207
225
|
/** Select exact local receivers before expansion; all targets still come from
|
|
208
226
|
* the complete validated projection. Selection supplies no attachment authority. */
|