rizolang 0.0.0-stage → 0.2.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.
Files changed (53) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +399 -2
  3. package/build/src/ast.d.ts +133 -0
  4. package/build/src/ast.js +4 -0
  5. package/build/src/ast.js.map +1 -0
  6. package/build/src/bin.d.ts +2 -0
  7. package/build/src/bin.js +8 -0
  8. package/build/src/bin.js.map +1 -0
  9. package/build/src/check-api.d.ts +97 -0
  10. package/build/src/check-api.js +506 -0
  11. package/build/src/check-api.js.map +1 -0
  12. package/build/src/checker.d.ts +53 -0
  13. package/build/src/checker.js +235 -0
  14. package/build/src/checker.js.map +1 -0
  15. package/build/src/cli.d.ts +11 -0
  16. package/build/src/cli.js +94 -0
  17. package/build/src/cli.js.map +1 -0
  18. package/build/src/compiler.d.ts +36 -0
  19. package/build/src/compiler.js +61 -0
  20. package/build/src/compiler.js.map +1 -0
  21. package/build/src/diagnostics.d.ts +35 -0
  22. package/build/src/diagnostics.js +69 -0
  23. package/build/src/diagnostics.js.map +1 -0
  24. package/build/src/emit/routes.d.ts +20 -0
  25. package/build/src/emit/routes.js +246 -0
  26. package/build/src/emit/routes.js.map +1 -0
  27. package/build/src/emit/sql.d.ts +12 -0
  28. package/build/src/emit/sql.js +83 -0
  29. package/build/src/emit/sql.js.map +1 -0
  30. package/build/src/emit/typescript.d.ts +13 -0
  31. package/build/src/emit/typescript.js +74 -0
  32. package/build/src/emit/typescript.js.map +1 -0
  33. package/build/src/lexer.d.ts +17 -0
  34. package/build/src/lexer.js +124 -0
  35. package/build/src/lexer.js.map +1 -0
  36. package/build/src/parser.d.ts +17 -0
  37. package/build/src/parser.js +399 -0
  38. package/build/src/parser.js.map +1 -0
  39. package/build/src/types.d.ts +42 -0
  40. package/build/src/types.js +77 -0
  41. package/build/src/types.js.map +1 -0
  42. package/build/src/version.d.ts +2 -0
  43. package/build/src/version.js +3 -0
  44. package/build/src/version.js.map +1 -0
  45. package/docs/SPEC-COMPACT.md +148 -0
  46. package/docs/SPEC.md +597 -0
  47. package/package.json +48 -4
  48. package/runtime/password.ts +58 -0
  49. package/runtime/ratelimit.ts +53 -0
  50. package/runtime/server.ts +449 -0
  51. package/runtime/session.ts +48 -0
  52. package/runtime/types.ts +76 -0
  53. package/runtime/validate.ts +133 -0
@@ -0,0 +1,133 @@
1
+ /**
2
+ * Rizo Lang runtime: input validation.
3
+ *
4
+ * Every value from a request (body fields and path parameters) passes through
5
+ * here before it reaches a query. Anything unexpected is rejected with a
6
+ * message that names the field; values are never echoed back.
7
+ */
8
+ import type { FieldKind, FieldSpec, PathPart } from "./types.ts";
9
+
10
+ export type Validated =
11
+ | { readonly ok: true; readonly values: ReadonlyMap<string, unknown> }
12
+ | { readonly ok: false; readonly field: string; readonly message: string };
13
+
14
+ const INT32_MIN = -2147483648;
15
+ const INT32_MAX = 2147483647;
16
+ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
17
+ const EMAIL = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
18
+ /** Date, or date and time with a required time zone. */
19
+ const ISO_DATE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,6})?)?(Z|[+-]\d{2}:\d{2}))?$/;
20
+ /** Path parameters of type Text are capped so URLs cannot carry huge values. */
21
+ const MAX_PATH_TEXT = 1000;
22
+
23
+ /** Length in Unicode code points, matching PostgreSQL's char_length(). */
24
+ const length = (s: string): number => [...s].length;
25
+
26
+ function describeKind(kind: FieldKind): string {
27
+ switch (kind) {
28
+ case "Text": return "text";
29
+ case "Password": return "text";
30
+ case "Email": return "an email address";
31
+ case "Number": return "a whole number";
32
+ case "Bool": return "true or false";
33
+ case "Date": return "an ISO 8601 date such as 2026-01-31T12:00:00Z";
34
+ case "ID": return "an ID (UUID)";
35
+ }
36
+ }
37
+
38
+ /** Validate one value. Returns the value to store, or an error message. */
39
+ export function validateValue(spec: Omit<FieldSpec, "required" | "nullable">, raw: unknown): { value: unknown } | { error: string } {
40
+ const { key, kind } = spec;
41
+ const bad = (): { error: string } => ({ error: `${key} must be ${describeKind(kind)}.` });
42
+ switch (kind) {
43
+ case "Text":
44
+ case "Password": {
45
+ if (typeof raw !== "string") return bad();
46
+ if (raw.includes("\u0000")) return { error: `${key} contains a character that is not allowed.` };
47
+ const n = length(raw);
48
+ if (spec.min !== undefined && n < spec.min) return { error: `${key} must be at least ${spec.min} characters.` };
49
+ if (spec.max !== undefined && n > spec.max) return { error: `${key} must be at most ${spec.max} characters.` };
50
+ return { value: raw };
51
+ }
52
+ case "Email": {
53
+ if (typeof raw !== "string") return bad();
54
+ const email = raw.trim().toLowerCase();
55
+ const n = length(email);
56
+ if (!EMAIL.test(email)) return bad();
57
+ if (spec.min !== undefined && n < spec.min) return { error: `${key} must be at least ${spec.min} characters.` };
58
+ if (spec.max !== undefined && n > spec.max) return { error: `${key} must be at most ${spec.max} characters.` };
59
+ return { value: email };
60
+ }
61
+ case "Number": {
62
+ if (typeof raw !== "number" || !Number.isInteger(raw) || raw < INT32_MIN || raw > INT32_MAX) return bad();
63
+ if (spec.min !== undefined && raw < spec.min) return { error: `${key} must be at least ${spec.min}.` };
64
+ if (spec.max !== undefined && raw > spec.max) return { error: `${key} must be at most ${spec.max}.` };
65
+ return { value: raw };
66
+ }
67
+ case "Bool":
68
+ return typeof raw === "boolean" ? { value: raw } : bad();
69
+ case "Date": {
70
+ if (typeof raw !== "string" || !ISO_DATE.test(raw)) return bad();
71
+ const d = new Date(raw);
72
+ return Number.isNaN(d.getTime()) ? bad() : { value: d };
73
+ }
74
+ case "ID":
75
+ return typeof raw === "string" && UUID.test(raw) ? { value: raw.toLowerCase() } : bad();
76
+ }
77
+ }
78
+
79
+ /**
80
+ * Validate a JSON request body against the endpoint's fields.
81
+ * `partial` is used for updates: every field is optional.
82
+ */
83
+ export function validateBody(specs: readonly FieldSpec[], body: unknown): Validated {
84
+ if (typeof body !== "object" || body === null || Array.isArray(body)) {
85
+ return { ok: false, field: "", message: "The request body must be a JSON object." };
86
+ }
87
+ const allowed = new Set(specs.map((s) => s.key));
88
+ for (const key of Object.keys(body)) {
89
+ if (!allowed.has(key)) {
90
+ const shown = key.length > 50 ? `${key.slice(0, 50)}…` : key;
91
+ return {
92
+ ok: false,
93
+ field: shown,
94
+ message: `Unknown field "${shown}". Allowed fields: ${[...allowed].join(", ") || "none"}.`,
95
+ };
96
+ }
97
+ }
98
+ const values = new Map<string, unknown>();
99
+ const record = body as Record<string, unknown>;
100
+ for (const spec of specs) {
101
+ if (!Object.hasOwn(record, spec.key)) {
102
+ if (spec.required) return { ok: false, field: spec.key, message: `${spec.key} is required.` };
103
+ continue;
104
+ }
105
+ const raw = record[spec.key];
106
+ if (raw === null) {
107
+ if (!spec.nullable) return { ok: false, field: spec.key, message: `${spec.key} cannot be null.` };
108
+ values.set(spec.key, null);
109
+ continue;
110
+ }
111
+ const r = validateValue(spec, raw);
112
+ if ("error" in r) return { ok: false, field: spec.key, message: r.error };
113
+ values.set(spec.key, r.value);
114
+ }
115
+ return { ok: true, values };
116
+ }
117
+
118
+ /** Validate a decoded path parameter. */
119
+ export function validatePathParam(part: Extract<PathPart, { param: string }>, raw: string): { value: unknown } | { error: string } {
120
+ const key = part.param;
121
+ switch (part.kind) {
122
+ case "Number":
123
+ if (!/^-?\d{1,10}$/.test(raw)) return { error: `${key} must be a whole number.` };
124
+ return validateValue({ key, kind: "Number" }, Number(raw));
125
+ case "Bool":
126
+ if (raw !== "true" && raw !== "false") return { error: `${key} must be true or false.` };
127
+ return { value: raw === "true" };
128
+ case "Text":
129
+ return validateValue({ key, kind: "Text", min: 1, max: MAX_PATH_TEXT }, raw);
130
+ default:
131
+ return validateValue({ key, kind: part.kind }, raw);
132
+ }
133
+ }