@datafn/server 0.1.3 → 0.1.4-maint.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/README.md +0 -48
- package/dist/index.cjs +124 -1254
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +5 -269
- package/dist/index.d.ts +5 -269
- package/dist/index.js +127 -1202
- package/dist/index.js.map +1 -1
- package/package.json +7 -14
- package/dist/placement.cjs +0 -143
- package/dist/placement.cjs.map +0 -1
- package/dist/placement.d.cts +0 -49
- package/dist/placement.d.ts +0 -49
- package/dist/placement.js +0 -139
- package/dist/placement.js.map +0 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@datafn/server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4-maint.0",
|
|
4
4
|
"description": "DataFn server runtime - HTTP endpoints for DFQL query, mutations, and sync",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -12,11 +12,6 @@
|
|
|
12
12
|
"types": "./dist/index.d.ts",
|
|
13
13
|
"import": "./dist/index.js",
|
|
14
14
|
"require": "./dist/index.cjs"
|
|
15
|
-
},
|
|
16
|
-
"./placement": {
|
|
17
|
-
"types": "./dist/placement.d.ts",
|
|
18
|
-
"import": "./dist/placement.js",
|
|
19
|
-
"require": "./dist/placement.cjs"
|
|
20
15
|
}
|
|
21
16
|
},
|
|
22
17
|
"files": [
|
|
@@ -48,24 +43,22 @@
|
|
|
48
43
|
"directory": "datafn/server"
|
|
49
44
|
},
|
|
50
45
|
"publishConfig": {
|
|
51
|
-
"access": "public"
|
|
46
|
+
"access": "public",
|
|
47
|
+
"tag": "maint"
|
|
52
48
|
},
|
|
53
49
|
"sideEffects": false,
|
|
54
50
|
"dependencies": {
|
|
55
|
-
"@datafn/core": "0.1.
|
|
56
|
-
"@superfunctions/db": "0.2.
|
|
57
|
-
"@superfunctions/http": "0.
|
|
51
|
+
"@datafn/core": "0.1.0",
|
|
52
|
+
"@superfunctions/db": "0.2.0",
|
|
53
|
+
"@superfunctions/http": "0.2.0",
|
|
58
54
|
"@superfunctions/observability": "0.0.1"
|
|
59
55
|
},
|
|
60
56
|
"devDependencies": {
|
|
61
|
-
"@datafn/client": "0.1.1",
|
|
62
57
|
"@types/better-sqlite3": "^7.6.13",
|
|
63
58
|
"@types/node": "^24.9.1",
|
|
64
|
-
"@types/ws": "8.18.1",
|
|
65
59
|
"better-sqlite3": "^12.5.0",
|
|
66
60
|
"tsup": "^8.5.0",
|
|
67
61
|
"typescript": "^5.9.3",
|
|
68
|
-
"vitest": "^3.2.4"
|
|
69
|
-
"ws": "8.18.0"
|
|
62
|
+
"vitest": "^3.2.4"
|
|
70
63
|
}
|
|
71
64
|
}
|
package/dist/placement.cjs
DELETED
|
@@ -1,143 +0,0 @@
|
|
|
1
|
-
'use strict';
|
|
2
|
-
|
|
3
|
-
// src/placement-policy.ts
|
|
4
|
-
var CONTINENT_CENTERS = {
|
|
5
|
-
AF: [1.65, 17.68],
|
|
6
|
-
AN: [-82.86, 135],
|
|
7
|
-
AS: [34.05, 100.62],
|
|
8
|
-
EU: [54.53, 15.26],
|
|
9
|
-
NA: [54.53, -105.26],
|
|
10
|
-
OC: [-22.74, 140.02],
|
|
11
|
-
SA: [-14.24, -51.93]
|
|
12
|
-
};
|
|
13
|
-
function finiteCoordinate(value, minimum, maximum) {
|
|
14
|
-
return value !== void 0 && Number.isFinite(value) && value >= minimum && value <= maximum;
|
|
15
|
-
}
|
|
16
|
-
function normalizedCandidates(input) {
|
|
17
|
-
const context = {
|
|
18
|
-
location: input.location ?? null,
|
|
19
|
-
preferredRegionId: normalizedPreferredRegionId(input.preferredRegionId)
|
|
20
|
-
};
|
|
21
|
-
const seen = /* @__PURE__ */ new Set();
|
|
22
|
-
const candidates = input.candidates.map((candidate) => {
|
|
23
|
-
const regionId = candidate.regionId.trim();
|
|
24
|
-
if (!regionId) throw new Error("DATAFN_PLACEMENT_REGION_ID_REQUIRED");
|
|
25
|
-
if (seen.has(regionId)) {
|
|
26
|
-
throw new Error(`DATAFN_PLACEMENT_REGION_DUPLICATE: ${regionId}`);
|
|
27
|
-
}
|
|
28
|
-
seen.add(regionId);
|
|
29
|
-
return regionId === candidate.regionId ? candidate : { ...candidate, regionId };
|
|
30
|
-
});
|
|
31
|
-
return candidates.filter(
|
|
32
|
-
(candidate) => (input.constraints ?? []).every(
|
|
33
|
-
(constraint) => constraint(candidate, context)
|
|
34
|
-
)
|
|
35
|
-
);
|
|
36
|
-
}
|
|
37
|
-
function normalizedPreferredRegionId(preferredRegionId) {
|
|
38
|
-
return preferredRegionId?.trim() || null;
|
|
39
|
-
}
|
|
40
|
-
function compareRegionIds(left, right) {
|
|
41
|
-
return left < right ? -1 : left > right ? 1 : 0;
|
|
42
|
-
}
|
|
43
|
-
function sourceCoordinates(location) {
|
|
44
|
-
if (!location) return null;
|
|
45
|
-
if (finiteCoordinate(location.latitude, -90, 90) && finiteCoordinate(location.longitude, -180, 180)) {
|
|
46
|
-
return {
|
|
47
|
-
coordinates: [location.latitude, location.longitude],
|
|
48
|
-
source: "coordinates"
|
|
49
|
-
};
|
|
50
|
-
}
|
|
51
|
-
const continent = location.continent?.toUpperCase();
|
|
52
|
-
const coordinates = continent ? CONTINENT_CENTERS[continent] : void 0;
|
|
53
|
-
return coordinates ? { coordinates, source: "continent" } : null;
|
|
54
|
-
}
|
|
55
|
-
function radians(degrees) {
|
|
56
|
-
return degrees * Math.PI / 180;
|
|
57
|
-
}
|
|
58
|
-
function distanceKilometers(source, target) {
|
|
59
|
-
const sourceLatitude = radians(source[0]);
|
|
60
|
-
const targetLatitude = radians(target[0]);
|
|
61
|
-
const latitudeDelta = radians(target[0] - source[0]);
|
|
62
|
-
const longitudeDelta = radians(target[1] - source[1]);
|
|
63
|
-
const haversine = Math.sin(latitudeDelta / 2) ** 2 + Math.cos(sourceLatitude) * Math.cos(targetLatitude) * Math.sin(longitudeDelta / 2) ** 2;
|
|
64
|
-
const clampedHaversine = Math.min(1, Math.max(0, haversine));
|
|
65
|
-
return 6371 * 2 * Math.atan2(Math.sqrt(clampedHaversine), Math.sqrt(1 - clampedHaversine));
|
|
66
|
-
}
|
|
67
|
-
function rankDatafnPlacementRegions(input) {
|
|
68
|
-
const candidates = normalizedCandidates(input);
|
|
69
|
-
const source = sourceCoordinates(input.location ?? null);
|
|
70
|
-
if (!source) return [];
|
|
71
|
-
return candidates.flatMap((candidate) => {
|
|
72
|
-
const { latitude, longitude } = candidate;
|
|
73
|
-
return finiteCoordinate(latitude, -90, 90) && finiteCoordinate(longitude, -180, 180) ? [
|
|
74
|
-
{
|
|
75
|
-
regionId: candidate.regionId,
|
|
76
|
-
source: source.source,
|
|
77
|
-
distanceKilometers: distanceKilometers(source.coordinates, [
|
|
78
|
-
latitude,
|
|
79
|
-
longitude
|
|
80
|
-
])
|
|
81
|
-
}
|
|
82
|
-
] : [];
|
|
83
|
-
}).sort(
|
|
84
|
-
(left, right) => (left.distanceKilometers ?? 0) - (right.distanceKilometers ?? 0) || compareRegionIds(left.regionId, right.regionId)
|
|
85
|
-
);
|
|
86
|
-
}
|
|
87
|
-
function stableIndex(key, length) {
|
|
88
|
-
let hash = 2166136261;
|
|
89
|
-
for (const byte of new TextEncoder().encode(key)) {
|
|
90
|
-
hash ^= byte;
|
|
91
|
-
hash = Math.imul(hash, 16777619) >>> 0;
|
|
92
|
-
}
|
|
93
|
-
return hash % length;
|
|
94
|
-
}
|
|
95
|
-
function selectDatafnPlacementRegion(input) {
|
|
96
|
-
const candidates = normalizedCandidates(input);
|
|
97
|
-
const preferredRegionId = normalizedPreferredRegionId(
|
|
98
|
-
input.preferredRegionId
|
|
99
|
-
);
|
|
100
|
-
if (preferredRegionId && candidates.some((candidate) => candidate.regionId === preferredRegionId)) {
|
|
101
|
-
return { regionId: preferredRegionId, source: "preferred" };
|
|
102
|
-
}
|
|
103
|
-
const ranked = rankDatafnPlacementRegions({
|
|
104
|
-
candidates,
|
|
105
|
-
location: input.location ?? null
|
|
106
|
-
});
|
|
107
|
-
const nearest = ranked[0];
|
|
108
|
-
if (nearest) return nearest;
|
|
109
|
-
if (input.stableKey !== void 0 && candidates.length > 0) {
|
|
110
|
-
const stableCandidates = [...candidates].sort(
|
|
111
|
-
(left, right) => compareRegionIds(left.regionId, right.regionId)
|
|
112
|
-
);
|
|
113
|
-
const selected = stableCandidates[stableIndex(input.stableKey, stableCandidates.length)];
|
|
114
|
-
if (selected) {
|
|
115
|
-
return { regionId: selected.regionId, source: "stable-fallback" };
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
return null;
|
|
119
|
-
}
|
|
120
|
-
function coordinate(value, minimum, maximum) {
|
|
121
|
-
const parsed = typeof value === "number" ? value : Number(value);
|
|
122
|
-
return Number.isFinite(parsed) && parsed >= minimum && parsed <= maximum ? parsed : void 0;
|
|
123
|
-
}
|
|
124
|
-
function readDatafnCloudflarePlacementLocation(request) {
|
|
125
|
-
const cf = request.cf;
|
|
126
|
-
if (!cf) return null;
|
|
127
|
-
const latitude = coordinate(cf.latitude, -90, 90);
|
|
128
|
-
const longitude = coordinate(cf.longitude, -180, 180);
|
|
129
|
-
const continent = typeof cf.continent === "string" && /^[A-Za-z]{2}$/u.test(cf.continent) ? cf.continent.toUpperCase() : void 0;
|
|
130
|
-
if (latitude === void 0 && longitude === void 0 && !continent)
|
|
131
|
-
return null;
|
|
132
|
-
return {
|
|
133
|
-
...latitude === void 0 ? {} : { latitude },
|
|
134
|
-
...longitude === void 0 ? {} : { longitude },
|
|
135
|
-
...continent ? { continent } : {}
|
|
136
|
-
};
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
exports.rankDatafnPlacementRegions = rankDatafnPlacementRegions;
|
|
140
|
-
exports.readDatafnCloudflarePlacementLocation = readDatafnCloudflarePlacementLocation;
|
|
141
|
-
exports.selectDatafnPlacementRegion = selectDatafnPlacementRegion;
|
|
142
|
-
//# sourceMappingURL=placement.cjs.map
|
|
143
|
-
//# sourceMappingURL=placement.cjs.map
|
package/dist/placement.cjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/placement-policy.ts"],"names":[],"mappings":"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","file":"placement.cjs","sourcesContent":["export interface DatafnPlacementRegionCandidate {\n readonly regionId: string;\n readonly latitude?: number;\n readonly longitude?: number;\n}\n\nexport interface DatafnPlacementLocation {\n readonly latitude?: number;\n readonly longitude?: number;\n readonly continent?: string;\n}\n\nexport interface DatafnPlacementConstraintContext {\n readonly location: DatafnPlacementLocation | null;\n readonly preferredRegionId: string | null;\n}\n\nexport type DatafnPlacementConstraint = (\n candidate: DatafnPlacementRegionCandidate,\n context: DatafnPlacementConstraintContext,\n) => boolean;\n\nexport type DatafnPlacementDecisionSource =\n | \"preferred\"\n | \"coordinates\"\n | \"continent\"\n | \"stable-fallback\";\n\nexport interface DatafnPlacementDecision {\n readonly regionId: string;\n readonly source: DatafnPlacementDecisionSource;\n readonly distanceKilometers?: number;\n}\n\nexport interface DatafnPlacementRankingInput {\n readonly candidates: readonly DatafnPlacementRegionCandidate[];\n readonly location?: DatafnPlacementLocation | null;\n readonly preferredRegionId?: string | null;\n readonly constraints?: readonly DatafnPlacementConstraint[];\n}\n\nexport interface DatafnPlacementSelectionInput\n extends DatafnPlacementRankingInput {\n /**\n * Optional stable key used only when neither a preferred region nor trusted\n * geographic signal can select an eligible region.\n */\n readonly stableKey?: string;\n}\n\nconst CONTINENT_CENTERS: Readonly<Record<string, readonly [number, number]>> = {\n AF: [1.65, 17.68],\n AN: [-82.86, 135],\n AS: [34.05, 100.62],\n EU: [54.53, 15.26],\n NA: [54.53, -105.26],\n OC: [-22.74, 140.02],\n SA: [-14.24, -51.93],\n};\n\nfunction finiteCoordinate(\n value: number | undefined,\n minimum: number,\n maximum: number,\n): value is number {\n return (\n value !== undefined &&\n Number.isFinite(value) &&\n value >= minimum &&\n value <= maximum\n );\n}\n\nfunction normalizedCandidates(\n input: DatafnPlacementRankingInput,\n): readonly DatafnPlacementRegionCandidate[] {\n const context: DatafnPlacementConstraintContext = {\n location: input.location ?? null,\n preferredRegionId: normalizedPreferredRegionId(input.preferredRegionId),\n };\n const seen = new Set<string>();\n const candidates = input.candidates.map((candidate) => {\n const regionId = candidate.regionId.trim();\n if (!regionId) throw new Error(\"DATAFN_PLACEMENT_REGION_ID_REQUIRED\");\n if (seen.has(regionId)) {\n throw new Error(`DATAFN_PLACEMENT_REGION_DUPLICATE: ${regionId}`);\n }\n seen.add(regionId);\n return regionId === candidate.regionId\n ? candidate\n : { ...candidate, regionId };\n });\n return candidates.filter((candidate) =>\n (input.constraints ?? []).every((constraint) =>\n constraint(candidate, context),\n ),\n );\n}\n\nfunction normalizedPreferredRegionId(\n preferredRegionId: string | null | undefined,\n): string | null {\n return preferredRegionId?.trim() || null;\n}\n\nfunction compareRegionIds(left: string, right: string): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction sourceCoordinates(location: DatafnPlacementLocation | null): {\n readonly coordinates: readonly [number, number];\n readonly source: \"coordinates\" | \"continent\";\n} | null {\n if (!location) return null;\n if (\n finiteCoordinate(location.latitude, -90, 90) &&\n finiteCoordinate(location.longitude, -180, 180)\n ) {\n return {\n coordinates: [location.latitude, location.longitude],\n source: \"coordinates\",\n };\n }\n const continent = location.continent?.toUpperCase();\n const coordinates = continent ? CONTINENT_CENTERS[continent] : undefined;\n return coordinates ? { coordinates, source: \"continent\" } : null;\n}\n\nfunction radians(degrees: number): number {\n return (degrees * Math.PI) / 180;\n}\n\nfunction distanceKilometers(\n source: readonly [number, number],\n target: readonly [number, number],\n): number {\n const sourceLatitude = radians(source[0]);\n const targetLatitude = radians(target[0]);\n const latitudeDelta = radians(target[0] - source[0]);\n const longitudeDelta = radians(target[1] - source[1]);\n const haversine =\n Math.sin(latitudeDelta / 2) ** 2 +\n Math.cos(sourceLatitude) *\n Math.cos(targetLatitude) *\n Math.sin(longitudeDelta / 2) ** 2;\n const clampedHaversine = Math.min(1, Math.max(0, haversine));\n return (\n 6_371 *\n 2 *\n Math.atan2(Math.sqrt(clampedHaversine), Math.sqrt(1 - clampedHaversine))\n );\n}\n\n/**\n * Ranks eligible regions by physical distance from a trusted client signal.\n * Region ID is the deterministic tie-breaker.\n */\nexport function rankDatafnPlacementRegions(\n input: DatafnPlacementRankingInput,\n): readonly DatafnPlacementDecision[] {\n const candidates = normalizedCandidates(input);\n const source = sourceCoordinates(input.location ?? null);\n if (!source) return [];\n return candidates\n .flatMap((candidate) => {\n const { latitude, longitude } = candidate;\n return finiteCoordinate(latitude, -90, 90) &&\n finiteCoordinate(longitude, -180, 180)\n ? [\n {\n regionId: candidate.regionId,\n source: source.source,\n distanceKilometers: distanceKilometers(source.coordinates, [\n latitude,\n longitude,\n ]),\n } satisfies DatafnPlacementDecision,\n ]\n : [];\n })\n .sort(\n (left, right) =>\n (left.distanceKilometers ?? 0) - (right.distanceKilometers ?? 0) ||\n compareRegionIds(left.regionId, right.regionId),\n );\n}\n\nfunction stableIndex(key: string, length: number): number {\n let hash = 2_166_136_261;\n for (const byte of new TextEncoder().encode(key)) {\n hash ^= byte;\n hash = Math.imul(hash, 16_777_619) >>> 0;\n }\n return hash % length;\n}\n\n/**\n * Selects an eligible region using explicit choice, trusted geography, then an\n * opt-in stable fallback. Product residency, health, and capacity policy is\n * supplied through constraints rather than embedded in DataFn.\n */\nexport function selectDatafnPlacementRegion(\n input: DatafnPlacementSelectionInput,\n): DatafnPlacementDecision | null {\n const candidates = normalizedCandidates(input);\n const preferredRegionId = normalizedPreferredRegionId(\n input.preferredRegionId,\n );\n if (\n preferredRegionId &&\n candidates.some((candidate) => candidate.regionId === preferredRegionId)\n ) {\n return { regionId: preferredRegionId, source: \"preferred\" };\n }\n\n const ranked = rankDatafnPlacementRegions({\n candidates,\n location: input.location ?? null,\n });\n const nearest = ranked[0];\n if (nearest) return nearest;\n\n if (input.stableKey !== undefined && candidates.length > 0) {\n const stableCandidates = [...candidates].sort((left, right) =>\n compareRegionIds(left.regionId, right.regionId),\n );\n const selected =\n stableCandidates[stableIndex(input.stableKey, stableCandidates.length)];\n if (selected) {\n return { regionId: selected.regionId, source: \"stable-fallback\" };\n }\n }\n return null;\n}\n\ninterface CloudflareLocationRequest extends Request {\n readonly cf?: {\n readonly continent?: unknown;\n readonly latitude?: unknown;\n readonly longitude?: unknown;\n };\n}\n\nfunction coordinate(\n value: unknown,\n minimum: number,\n maximum: number,\n): number | undefined {\n const parsed = typeof value === \"number\" ? value : Number(value);\n return Number.isFinite(parsed) && parsed >= minimum && parsed <= maximum\n ? parsed\n : undefined;\n}\n\n/** Reads Cloudflare's trusted request.cf location without requiring Workers types. */\nexport function readDatafnCloudflarePlacementLocation(\n request: Request,\n): DatafnPlacementLocation | null {\n const cf = (request as CloudflareLocationRequest).cf;\n if (!cf) return null;\n const latitude = coordinate(cf.latitude, -90, 90);\n const longitude = coordinate(cf.longitude, -180, 180);\n const continent =\n typeof cf.continent === \"string\" && /^[A-Za-z]{2}$/u.test(cf.continent)\n ? cf.continent.toUpperCase()\n : undefined;\n if (latitude === undefined && longitude === undefined && !continent)\n return null;\n return {\n ...(latitude === undefined ? {} : { latitude }),\n ...(longitude === undefined ? {} : { longitude }),\n ...(continent ? { continent } : {}),\n };\n}\n"]}
|
package/dist/placement.d.cts
DELETED
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
interface DatafnPlacementRegionCandidate {
|
|
2
|
-
readonly regionId: string;
|
|
3
|
-
readonly latitude?: number;
|
|
4
|
-
readonly longitude?: number;
|
|
5
|
-
}
|
|
6
|
-
interface DatafnPlacementLocation {
|
|
7
|
-
readonly latitude?: number;
|
|
8
|
-
readonly longitude?: number;
|
|
9
|
-
readonly continent?: string;
|
|
10
|
-
}
|
|
11
|
-
interface DatafnPlacementConstraintContext {
|
|
12
|
-
readonly location: DatafnPlacementLocation | null;
|
|
13
|
-
readonly preferredRegionId: string | null;
|
|
14
|
-
}
|
|
15
|
-
type DatafnPlacementConstraint = (candidate: DatafnPlacementRegionCandidate, context: DatafnPlacementConstraintContext) => boolean;
|
|
16
|
-
type DatafnPlacementDecisionSource = "preferred" | "coordinates" | "continent" | "stable-fallback";
|
|
17
|
-
interface DatafnPlacementDecision {
|
|
18
|
-
readonly regionId: string;
|
|
19
|
-
readonly source: DatafnPlacementDecisionSource;
|
|
20
|
-
readonly distanceKilometers?: number;
|
|
21
|
-
}
|
|
22
|
-
interface DatafnPlacementRankingInput {
|
|
23
|
-
readonly candidates: readonly DatafnPlacementRegionCandidate[];
|
|
24
|
-
readonly location?: DatafnPlacementLocation | null;
|
|
25
|
-
readonly preferredRegionId?: string | null;
|
|
26
|
-
readonly constraints?: readonly DatafnPlacementConstraint[];
|
|
27
|
-
}
|
|
28
|
-
interface DatafnPlacementSelectionInput extends DatafnPlacementRankingInput {
|
|
29
|
-
/**
|
|
30
|
-
* Optional stable key used only when neither a preferred region nor trusted
|
|
31
|
-
* geographic signal can select an eligible region.
|
|
32
|
-
*/
|
|
33
|
-
readonly stableKey?: string;
|
|
34
|
-
}
|
|
35
|
-
/**
|
|
36
|
-
* Ranks eligible regions by physical distance from a trusted client signal.
|
|
37
|
-
* Region ID is the deterministic tie-breaker.
|
|
38
|
-
*/
|
|
39
|
-
declare function rankDatafnPlacementRegions(input: DatafnPlacementRankingInput): readonly DatafnPlacementDecision[];
|
|
40
|
-
/**
|
|
41
|
-
* Selects an eligible region using explicit choice, trusted geography, then an
|
|
42
|
-
* opt-in stable fallback. Product residency, health, and capacity policy is
|
|
43
|
-
* supplied through constraints rather than embedded in DataFn.
|
|
44
|
-
*/
|
|
45
|
-
declare function selectDatafnPlacementRegion(input: DatafnPlacementSelectionInput): DatafnPlacementDecision | null;
|
|
46
|
-
/** Reads Cloudflare's trusted request.cf location without requiring Workers types. */
|
|
47
|
-
declare function readDatafnCloudflarePlacementLocation(request: Request): DatafnPlacementLocation | null;
|
|
48
|
-
|
|
49
|
-
export { type DatafnPlacementConstraint, type DatafnPlacementConstraintContext, type DatafnPlacementDecision, type DatafnPlacementDecisionSource, type DatafnPlacementLocation, type DatafnPlacementRankingInput, type DatafnPlacementRegionCandidate, type DatafnPlacementSelectionInput, rankDatafnPlacementRegions, readDatafnCloudflarePlacementLocation, selectDatafnPlacementRegion };
|
package/dist/placement.d.ts
DELETED
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
interface DatafnPlacementRegionCandidate {
|
|
2
|
-
readonly regionId: string;
|
|
3
|
-
readonly latitude?: number;
|
|
4
|
-
readonly longitude?: number;
|
|
5
|
-
}
|
|
6
|
-
interface DatafnPlacementLocation {
|
|
7
|
-
readonly latitude?: number;
|
|
8
|
-
readonly longitude?: number;
|
|
9
|
-
readonly continent?: string;
|
|
10
|
-
}
|
|
11
|
-
interface DatafnPlacementConstraintContext {
|
|
12
|
-
readonly location: DatafnPlacementLocation | null;
|
|
13
|
-
readonly preferredRegionId: string | null;
|
|
14
|
-
}
|
|
15
|
-
type DatafnPlacementConstraint = (candidate: DatafnPlacementRegionCandidate, context: DatafnPlacementConstraintContext) => boolean;
|
|
16
|
-
type DatafnPlacementDecisionSource = "preferred" | "coordinates" | "continent" | "stable-fallback";
|
|
17
|
-
interface DatafnPlacementDecision {
|
|
18
|
-
readonly regionId: string;
|
|
19
|
-
readonly source: DatafnPlacementDecisionSource;
|
|
20
|
-
readonly distanceKilometers?: number;
|
|
21
|
-
}
|
|
22
|
-
interface DatafnPlacementRankingInput {
|
|
23
|
-
readonly candidates: readonly DatafnPlacementRegionCandidate[];
|
|
24
|
-
readonly location?: DatafnPlacementLocation | null;
|
|
25
|
-
readonly preferredRegionId?: string | null;
|
|
26
|
-
readonly constraints?: readonly DatafnPlacementConstraint[];
|
|
27
|
-
}
|
|
28
|
-
interface DatafnPlacementSelectionInput extends DatafnPlacementRankingInput {
|
|
29
|
-
/**
|
|
30
|
-
* Optional stable key used only when neither a preferred region nor trusted
|
|
31
|
-
* geographic signal can select an eligible region.
|
|
32
|
-
*/
|
|
33
|
-
readonly stableKey?: string;
|
|
34
|
-
}
|
|
35
|
-
/**
|
|
36
|
-
* Ranks eligible regions by physical distance from a trusted client signal.
|
|
37
|
-
* Region ID is the deterministic tie-breaker.
|
|
38
|
-
*/
|
|
39
|
-
declare function rankDatafnPlacementRegions(input: DatafnPlacementRankingInput): readonly DatafnPlacementDecision[];
|
|
40
|
-
/**
|
|
41
|
-
* Selects an eligible region using explicit choice, trusted geography, then an
|
|
42
|
-
* opt-in stable fallback. Product residency, health, and capacity policy is
|
|
43
|
-
* supplied through constraints rather than embedded in DataFn.
|
|
44
|
-
*/
|
|
45
|
-
declare function selectDatafnPlacementRegion(input: DatafnPlacementSelectionInput): DatafnPlacementDecision | null;
|
|
46
|
-
/** Reads Cloudflare's trusted request.cf location without requiring Workers types. */
|
|
47
|
-
declare function readDatafnCloudflarePlacementLocation(request: Request): DatafnPlacementLocation | null;
|
|
48
|
-
|
|
49
|
-
export { type DatafnPlacementConstraint, type DatafnPlacementConstraintContext, type DatafnPlacementDecision, type DatafnPlacementDecisionSource, type DatafnPlacementLocation, type DatafnPlacementRankingInput, type DatafnPlacementRegionCandidate, type DatafnPlacementSelectionInput, rankDatafnPlacementRegions, readDatafnCloudflarePlacementLocation, selectDatafnPlacementRegion };
|
package/dist/placement.js
DELETED
|
@@ -1,139 +0,0 @@
|
|
|
1
|
-
// src/placement-policy.ts
|
|
2
|
-
var CONTINENT_CENTERS = {
|
|
3
|
-
AF: [1.65, 17.68],
|
|
4
|
-
AN: [-82.86, 135],
|
|
5
|
-
AS: [34.05, 100.62],
|
|
6
|
-
EU: [54.53, 15.26],
|
|
7
|
-
NA: [54.53, -105.26],
|
|
8
|
-
OC: [-22.74, 140.02],
|
|
9
|
-
SA: [-14.24, -51.93]
|
|
10
|
-
};
|
|
11
|
-
function finiteCoordinate(value, minimum, maximum) {
|
|
12
|
-
return value !== void 0 && Number.isFinite(value) && value >= minimum && value <= maximum;
|
|
13
|
-
}
|
|
14
|
-
function normalizedCandidates(input) {
|
|
15
|
-
const context = {
|
|
16
|
-
location: input.location ?? null,
|
|
17
|
-
preferredRegionId: normalizedPreferredRegionId(input.preferredRegionId)
|
|
18
|
-
};
|
|
19
|
-
const seen = /* @__PURE__ */ new Set();
|
|
20
|
-
const candidates = input.candidates.map((candidate) => {
|
|
21
|
-
const regionId = candidate.regionId.trim();
|
|
22
|
-
if (!regionId) throw new Error("DATAFN_PLACEMENT_REGION_ID_REQUIRED");
|
|
23
|
-
if (seen.has(regionId)) {
|
|
24
|
-
throw new Error(`DATAFN_PLACEMENT_REGION_DUPLICATE: ${regionId}`);
|
|
25
|
-
}
|
|
26
|
-
seen.add(regionId);
|
|
27
|
-
return regionId === candidate.regionId ? candidate : { ...candidate, regionId };
|
|
28
|
-
});
|
|
29
|
-
return candidates.filter(
|
|
30
|
-
(candidate) => (input.constraints ?? []).every(
|
|
31
|
-
(constraint) => constraint(candidate, context)
|
|
32
|
-
)
|
|
33
|
-
);
|
|
34
|
-
}
|
|
35
|
-
function normalizedPreferredRegionId(preferredRegionId) {
|
|
36
|
-
return preferredRegionId?.trim() || null;
|
|
37
|
-
}
|
|
38
|
-
function compareRegionIds(left, right) {
|
|
39
|
-
return left < right ? -1 : left > right ? 1 : 0;
|
|
40
|
-
}
|
|
41
|
-
function sourceCoordinates(location) {
|
|
42
|
-
if (!location) return null;
|
|
43
|
-
if (finiteCoordinate(location.latitude, -90, 90) && finiteCoordinate(location.longitude, -180, 180)) {
|
|
44
|
-
return {
|
|
45
|
-
coordinates: [location.latitude, location.longitude],
|
|
46
|
-
source: "coordinates"
|
|
47
|
-
};
|
|
48
|
-
}
|
|
49
|
-
const continent = location.continent?.toUpperCase();
|
|
50
|
-
const coordinates = continent ? CONTINENT_CENTERS[continent] : void 0;
|
|
51
|
-
return coordinates ? { coordinates, source: "continent" } : null;
|
|
52
|
-
}
|
|
53
|
-
function radians(degrees) {
|
|
54
|
-
return degrees * Math.PI / 180;
|
|
55
|
-
}
|
|
56
|
-
function distanceKilometers(source, target) {
|
|
57
|
-
const sourceLatitude = radians(source[0]);
|
|
58
|
-
const targetLatitude = radians(target[0]);
|
|
59
|
-
const latitudeDelta = radians(target[0] - source[0]);
|
|
60
|
-
const longitudeDelta = radians(target[1] - source[1]);
|
|
61
|
-
const haversine = Math.sin(latitudeDelta / 2) ** 2 + Math.cos(sourceLatitude) * Math.cos(targetLatitude) * Math.sin(longitudeDelta / 2) ** 2;
|
|
62
|
-
const clampedHaversine = Math.min(1, Math.max(0, haversine));
|
|
63
|
-
return 6371 * 2 * Math.atan2(Math.sqrt(clampedHaversine), Math.sqrt(1 - clampedHaversine));
|
|
64
|
-
}
|
|
65
|
-
function rankDatafnPlacementRegions(input) {
|
|
66
|
-
const candidates = normalizedCandidates(input);
|
|
67
|
-
const source = sourceCoordinates(input.location ?? null);
|
|
68
|
-
if (!source) return [];
|
|
69
|
-
return candidates.flatMap((candidate) => {
|
|
70
|
-
const { latitude, longitude } = candidate;
|
|
71
|
-
return finiteCoordinate(latitude, -90, 90) && finiteCoordinate(longitude, -180, 180) ? [
|
|
72
|
-
{
|
|
73
|
-
regionId: candidate.regionId,
|
|
74
|
-
source: source.source,
|
|
75
|
-
distanceKilometers: distanceKilometers(source.coordinates, [
|
|
76
|
-
latitude,
|
|
77
|
-
longitude
|
|
78
|
-
])
|
|
79
|
-
}
|
|
80
|
-
] : [];
|
|
81
|
-
}).sort(
|
|
82
|
-
(left, right) => (left.distanceKilometers ?? 0) - (right.distanceKilometers ?? 0) || compareRegionIds(left.regionId, right.regionId)
|
|
83
|
-
);
|
|
84
|
-
}
|
|
85
|
-
function stableIndex(key, length) {
|
|
86
|
-
let hash = 2166136261;
|
|
87
|
-
for (const byte of new TextEncoder().encode(key)) {
|
|
88
|
-
hash ^= byte;
|
|
89
|
-
hash = Math.imul(hash, 16777619) >>> 0;
|
|
90
|
-
}
|
|
91
|
-
return hash % length;
|
|
92
|
-
}
|
|
93
|
-
function selectDatafnPlacementRegion(input) {
|
|
94
|
-
const candidates = normalizedCandidates(input);
|
|
95
|
-
const preferredRegionId = normalizedPreferredRegionId(
|
|
96
|
-
input.preferredRegionId
|
|
97
|
-
);
|
|
98
|
-
if (preferredRegionId && candidates.some((candidate) => candidate.regionId === preferredRegionId)) {
|
|
99
|
-
return { regionId: preferredRegionId, source: "preferred" };
|
|
100
|
-
}
|
|
101
|
-
const ranked = rankDatafnPlacementRegions({
|
|
102
|
-
candidates,
|
|
103
|
-
location: input.location ?? null
|
|
104
|
-
});
|
|
105
|
-
const nearest = ranked[0];
|
|
106
|
-
if (nearest) return nearest;
|
|
107
|
-
if (input.stableKey !== void 0 && candidates.length > 0) {
|
|
108
|
-
const stableCandidates = [...candidates].sort(
|
|
109
|
-
(left, right) => compareRegionIds(left.regionId, right.regionId)
|
|
110
|
-
);
|
|
111
|
-
const selected = stableCandidates[stableIndex(input.stableKey, stableCandidates.length)];
|
|
112
|
-
if (selected) {
|
|
113
|
-
return { regionId: selected.regionId, source: "stable-fallback" };
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
return null;
|
|
117
|
-
}
|
|
118
|
-
function coordinate(value, minimum, maximum) {
|
|
119
|
-
const parsed = typeof value === "number" ? value : Number(value);
|
|
120
|
-
return Number.isFinite(parsed) && parsed >= minimum && parsed <= maximum ? parsed : void 0;
|
|
121
|
-
}
|
|
122
|
-
function readDatafnCloudflarePlacementLocation(request) {
|
|
123
|
-
const cf = request.cf;
|
|
124
|
-
if (!cf) return null;
|
|
125
|
-
const latitude = coordinate(cf.latitude, -90, 90);
|
|
126
|
-
const longitude = coordinate(cf.longitude, -180, 180);
|
|
127
|
-
const continent = typeof cf.continent === "string" && /^[A-Za-z]{2}$/u.test(cf.continent) ? cf.continent.toUpperCase() : void 0;
|
|
128
|
-
if (latitude === void 0 && longitude === void 0 && !continent)
|
|
129
|
-
return null;
|
|
130
|
-
return {
|
|
131
|
-
...latitude === void 0 ? {} : { latitude },
|
|
132
|
-
...longitude === void 0 ? {} : { longitude },
|
|
133
|
-
...continent ? { continent } : {}
|
|
134
|
-
};
|
|
135
|
-
}
|
|
136
|
-
|
|
137
|
-
export { rankDatafnPlacementRegions, readDatafnCloudflarePlacementLocation, selectDatafnPlacementRegion };
|
|
138
|
-
//# sourceMappingURL=placement.js.map
|
|
139
|
-
//# sourceMappingURL=placement.js.map
|
package/dist/placement.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/placement-policy.ts"],"names":[],"mappings":"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","file":"placement.js","sourcesContent":["export interface DatafnPlacementRegionCandidate {\n readonly regionId: string;\n readonly latitude?: number;\n readonly longitude?: number;\n}\n\nexport interface DatafnPlacementLocation {\n readonly latitude?: number;\n readonly longitude?: number;\n readonly continent?: string;\n}\n\nexport interface DatafnPlacementConstraintContext {\n readonly location: DatafnPlacementLocation | null;\n readonly preferredRegionId: string | null;\n}\n\nexport type DatafnPlacementConstraint = (\n candidate: DatafnPlacementRegionCandidate,\n context: DatafnPlacementConstraintContext,\n) => boolean;\n\nexport type DatafnPlacementDecisionSource =\n | \"preferred\"\n | \"coordinates\"\n | \"continent\"\n | \"stable-fallback\";\n\nexport interface DatafnPlacementDecision {\n readonly regionId: string;\n readonly source: DatafnPlacementDecisionSource;\n readonly distanceKilometers?: number;\n}\n\nexport interface DatafnPlacementRankingInput {\n readonly candidates: readonly DatafnPlacementRegionCandidate[];\n readonly location?: DatafnPlacementLocation | null;\n readonly preferredRegionId?: string | null;\n readonly constraints?: readonly DatafnPlacementConstraint[];\n}\n\nexport interface DatafnPlacementSelectionInput\n extends DatafnPlacementRankingInput {\n /**\n * Optional stable key used only when neither a preferred region nor trusted\n * geographic signal can select an eligible region.\n */\n readonly stableKey?: string;\n}\n\nconst CONTINENT_CENTERS: Readonly<Record<string, readonly [number, number]>> = {\n AF: [1.65, 17.68],\n AN: [-82.86, 135],\n AS: [34.05, 100.62],\n EU: [54.53, 15.26],\n NA: [54.53, -105.26],\n OC: [-22.74, 140.02],\n SA: [-14.24, -51.93],\n};\n\nfunction finiteCoordinate(\n value: number | undefined,\n minimum: number,\n maximum: number,\n): value is number {\n return (\n value !== undefined &&\n Number.isFinite(value) &&\n value >= minimum &&\n value <= maximum\n );\n}\n\nfunction normalizedCandidates(\n input: DatafnPlacementRankingInput,\n): readonly DatafnPlacementRegionCandidate[] {\n const context: DatafnPlacementConstraintContext = {\n location: input.location ?? null,\n preferredRegionId: normalizedPreferredRegionId(input.preferredRegionId),\n };\n const seen = new Set<string>();\n const candidates = input.candidates.map((candidate) => {\n const regionId = candidate.regionId.trim();\n if (!regionId) throw new Error(\"DATAFN_PLACEMENT_REGION_ID_REQUIRED\");\n if (seen.has(regionId)) {\n throw new Error(`DATAFN_PLACEMENT_REGION_DUPLICATE: ${regionId}`);\n }\n seen.add(regionId);\n return regionId === candidate.regionId\n ? candidate\n : { ...candidate, regionId };\n });\n return candidates.filter((candidate) =>\n (input.constraints ?? []).every((constraint) =>\n constraint(candidate, context),\n ),\n );\n}\n\nfunction normalizedPreferredRegionId(\n preferredRegionId: string | null | undefined,\n): string | null {\n return preferredRegionId?.trim() || null;\n}\n\nfunction compareRegionIds(left: string, right: string): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction sourceCoordinates(location: DatafnPlacementLocation | null): {\n readonly coordinates: readonly [number, number];\n readonly source: \"coordinates\" | \"continent\";\n} | null {\n if (!location) return null;\n if (\n finiteCoordinate(location.latitude, -90, 90) &&\n finiteCoordinate(location.longitude, -180, 180)\n ) {\n return {\n coordinates: [location.latitude, location.longitude],\n source: \"coordinates\",\n };\n }\n const continent = location.continent?.toUpperCase();\n const coordinates = continent ? CONTINENT_CENTERS[continent] : undefined;\n return coordinates ? { coordinates, source: \"continent\" } : null;\n}\n\nfunction radians(degrees: number): number {\n return (degrees * Math.PI) / 180;\n}\n\nfunction distanceKilometers(\n source: readonly [number, number],\n target: readonly [number, number],\n): number {\n const sourceLatitude = radians(source[0]);\n const targetLatitude = radians(target[0]);\n const latitudeDelta = radians(target[0] - source[0]);\n const longitudeDelta = radians(target[1] - source[1]);\n const haversine =\n Math.sin(latitudeDelta / 2) ** 2 +\n Math.cos(sourceLatitude) *\n Math.cos(targetLatitude) *\n Math.sin(longitudeDelta / 2) ** 2;\n const clampedHaversine = Math.min(1, Math.max(0, haversine));\n return (\n 6_371 *\n 2 *\n Math.atan2(Math.sqrt(clampedHaversine), Math.sqrt(1 - clampedHaversine))\n );\n}\n\n/**\n * Ranks eligible regions by physical distance from a trusted client signal.\n * Region ID is the deterministic tie-breaker.\n */\nexport function rankDatafnPlacementRegions(\n input: DatafnPlacementRankingInput,\n): readonly DatafnPlacementDecision[] {\n const candidates = normalizedCandidates(input);\n const source = sourceCoordinates(input.location ?? null);\n if (!source) return [];\n return candidates\n .flatMap((candidate) => {\n const { latitude, longitude } = candidate;\n return finiteCoordinate(latitude, -90, 90) &&\n finiteCoordinate(longitude, -180, 180)\n ? [\n {\n regionId: candidate.regionId,\n source: source.source,\n distanceKilometers: distanceKilometers(source.coordinates, [\n latitude,\n longitude,\n ]),\n } satisfies DatafnPlacementDecision,\n ]\n : [];\n })\n .sort(\n (left, right) =>\n (left.distanceKilometers ?? 0) - (right.distanceKilometers ?? 0) ||\n compareRegionIds(left.regionId, right.regionId),\n );\n}\n\nfunction stableIndex(key: string, length: number): number {\n let hash = 2_166_136_261;\n for (const byte of new TextEncoder().encode(key)) {\n hash ^= byte;\n hash = Math.imul(hash, 16_777_619) >>> 0;\n }\n return hash % length;\n}\n\n/**\n * Selects an eligible region using explicit choice, trusted geography, then an\n * opt-in stable fallback. Product residency, health, and capacity policy is\n * supplied through constraints rather than embedded in DataFn.\n */\nexport function selectDatafnPlacementRegion(\n input: DatafnPlacementSelectionInput,\n): DatafnPlacementDecision | null {\n const candidates = normalizedCandidates(input);\n const preferredRegionId = normalizedPreferredRegionId(\n input.preferredRegionId,\n );\n if (\n preferredRegionId &&\n candidates.some((candidate) => candidate.regionId === preferredRegionId)\n ) {\n return { regionId: preferredRegionId, source: \"preferred\" };\n }\n\n const ranked = rankDatafnPlacementRegions({\n candidates,\n location: input.location ?? null,\n });\n const nearest = ranked[0];\n if (nearest) return nearest;\n\n if (input.stableKey !== undefined && candidates.length > 0) {\n const stableCandidates = [...candidates].sort((left, right) =>\n compareRegionIds(left.regionId, right.regionId),\n );\n const selected =\n stableCandidates[stableIndex(input.stableKey, stableCandidates.length)];\n if (selected) {\n return { regionId: selected.regionId, source: \"stable-fallback\" };\n }\n }\n return null;\n}\n\ninterface CloudflareLocationRequest extends Request {\n readonly cf?: {\n readonly continent?: unknown;\n readonly latitude?: unknown;\n readonly longitude?: unknown;\n };\n}\n\nfunction coordinate(\n value: unknown,\n minimum: number,\n maximum: number,\n): number | undefined {\n const parsed = typeof value === \"number\" ? value : Number(value);\n return Number.isFinite(parsed) && parsed >= minimum && parsed <= maximum\n ? parsed\n : undefined;\n}\n\n/** Reads Cloudflare's trusted request.cf location without requiring Workers types. */\nexport function readDatafnCloudflarePlacementLocation(\n request: Request,\n): DatafnPlacementLocation | null {\n const cf = (request as CloudflareLocationRequest).cf;\n if (!cf) return null;\n const latitude = coordinate(cf.latitude, -90, 90);\n const longitude = coordinate(cf.longitude, -180, 180);\n const continent =\n typeof cf.continent === \"string\" && /^[A-Za-z]{2}$/u.test(cf.continent)\n ? cf.continent.toUpperCase()\n : undefined;\n if (latitude === undefined && longitude === undefined && !continent)\n return null;\n return {\n ...(latitude === undefined ? {} : { latitude }),\n ...(longitude === undefined ? {} : { longitude }),\n ...(continent ? { continent } : {}),\n };\n}\n"]}
|