@africode/core 5.0.10 → 5.0.13
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/AGENTS.md +585 -585
- package/AGENT_INSTRUCTIONS.md +595 -595
- package/COMPONENT_SCHEMA.json +1826 -1800
- package/LICENSE +623 -623
- package/README.md +476 -476
- package/bin/africode.js +73 -73
- package/bin/cli.ts +82 -82
- package/bin/create-africode.js +220 -220
- package/bin/scaffold.ts +218 -218
- package/components/accordion.js +183 -183
- package/components/alert.js +131 -131
- package/components/auth-form.js +154 -154
- package/components/auth.js +172 -172
- package/components/avatar.js +117 -117
- package/components/badge.js +104 -104
- package/components/base.d.ts +139 -139
- package/components/base.js +234 -234
- package/components/breadcrumb.js +76 -72
- package/components/button.js +164 -164
- package/components/card.js +144 -137
- package/components/carousel.js +32 -32
- package/components/cart-drawer.js +28 -28
- package/components/code-block.js +20 -20
- package/components/contact-form.js +25 -25
- package/components/cookie-consent.js +23 -23
- package/components/cta-banner.js +38 -38
- package/components/cultural-card.js +243 -243
- package/components/dashboard-activity-list.js +103 -103
- package/components/dashboard-card.js +85 -85
- package/components/dashboard-metric.js +81 -81
- package/components/dashboard-shell.js +85 -85
- package/components/dashboard-topbar.js +84 -84
- package/components/divider.js +83 -83
- package/components/dropdown.js +171 -171
- package/components/error-boundary.js +155 -155
- package/components/faq-accordion.js +23 -23
- package/components/feature-grid.js +85 -85
- package/components/file-uploader.js +22 -22
- package/components/filter-bar.js +19 -19
- package/components/footer.js +113 -113
- package/components/form.js +131 -131
- package/components/gallery.js +22 -22
- package/components/hero.js +140 -138
- package/components/icon.js +36 -36
- package/components/index.js +128 -128
- package/components/input.js +252 -256
- package/components/kanga-card.js +185 -185
- package/components/kyc-upload.js +173 -173
- package/components/language-switcher.js +108 -108
- package/components/loader.js +80 -80
- package/components/modal.js +262 -262
- package/components/motion.js +84 -84
- package/components/nav-drawer.js +216 -216
- package/components/navbar.js +243 -236
- package/components/newsletter-signup.js +24 -24
- package/components/pagination.js +31 -31
- package/components/pattern-showcase.js +225 -225
- package/components/pricing-card.js +100 -100
- package/components/product-card.js +41 -41
- package/components/progress.js +132 -134
- package/components/react.js +111 -111
- package/components/search-box.js +24 -24
- package/components/section.js +54 -54
- package/components/select.js +321 -322
- package/components/sidebar.js +180 -180
- package/components/simple-chart.js +22 -22
- package/components/skeleton.js +85 -85
- package/components/stepper.js +28 -28
- package/components/table.js +181 -181
- package/components/tabs.js +202 -202
- package/components/team-grid.js +23 -23
- package/components/testimonial.js +94 -94
- package/components/theme-toggle.js +82 -82
- package/components/toast.js +139 -139
- package/components/tooltip.js +167 -167
- package/components/transaction-ledger.js +138 -138
- package/components/ui-avatar.js +79 -79
- package/components/ui-badge.js +61 -61
- package/components/ui-button.js +149 -149
- package/components/ui-card.js +74 -75
- package/components/ui-chip.js +87 -87
- package/components/ui-input.js +110 -110
- package/components/ui-popover.js +84 -84
- package/components/ui-progress-ring.js +60 -60
- package/components/ui-select.js +85 -85
- package/components/ui-stat.js +75 -75
- package/components/ui-switch.js +85 -85
- package/components/ui-table.js +69 -69
- package/components/ui-tabs.js +99 -99
- package/components/ui-tag.js +64 -64
- package/components/ui-textarea.js +84 -84
- package/components/ui-tooltip.js +66 -66
- package/components/video-player.js +22 -22
- package/components/wallet-balance.js +114 -114
- package/core/a2ui-schema-manager.js +351 -351
- package/core/a2ui.js +696 -696
- package/core/actions.js +27 -27
- package/core/bun-runtime.js +398 -397
- package/core/cli/commands/add.js +23 -23
- package/core/cli/commands/audit.js +58 -58
- package/core/cli/commands/build.js +193 -193
- package/core/cli/commands/create-plugin.js +241 -241
- package/core/cli/commands/dev.js +252 -285
- package/core/cli/commands/lint.js +23 -23
- package/core/cli/commands/test.js +33 -34
- package/core/cli/migrator.js +71 -71
- package/core/cli/ui.js +56 -56
- package/core/compliance.js +823 -823
- package/core/config.js +265 -265
- package/core/db-advanced.js +478 -481
- package/core/db.js +282 -284
- package/core/enhanced-hmr.js +406 -406
- package/core/errors.js +222 -222
- package/core/file-router.js +52 -50
- package/core/hmr-client.js +203 -204
- package/core/hmr.js +205 -197
- package/core/html.d.ts +30 -30
- package/core/html.js +84 -84
- package/core/hydration.js +52 -52
- package/core/lipa-namba-journey.js +548 -605
- package/core/logging.js +14 -14
- package/core/middleware.js +145 -145
- package/core/motion.js +106 -106
- package/core/nida-cig-middleware.js +417 -460
- package/core/patterns.d.ts +124 -124
- package/core/patterns.js +947 -1001
- package/core/plugins/index.js +345 -345
- package/core/request-analytics.js +253 -253
- package/core/request-identity.js +93 -93
- package/core/router.js +386 -386
- package/core/sdk-browser.js +140 -140
- package/core/sdk-client.js +61 -61
- package/core/sdk.d.ts +133 -133
- package/core/sdk.js +148 -148
- package/core/seo.js +76 -76
- package/core/server/auth-endpoints.js +339 -339
- package/core/server/auth.js +180 -180
- package/core/server/csrf.js +200 -206
- package/core/server/db.js +39 -39
- package/core/server/middleware.js +324 -324
- package/core/server/rate-limit.js +238 -238
- package/core/server/render.js +67 -69
- package/core/server/router.js +102 -120
- package/core/session-store.js +68 -68
- package/core/shim.js +28 -28
- package/core/state.d.ts +86 -86
- package/core/state.js +276 -276
- package/core/store.d.ts +122 -122
- package/core/store.js +61 -61
- package/core/validation.d.ts +232 -232
- package/core/validation.js +602 -602
- package/core/websocket.js +656 -641
- package/dist/africode.js +233 -230
- package/dist/africode.js.map +83 -83
- package/dist/build-info.json +3 -3
- package/dist/components.js +195 -192
- package/dist/components.js.map +73 -73
- package/dist/styles/africanity.css +321 -321
- package/dist/styles/typography.css +140 -140
- package/docs/IDE-Guide.md +50 -50
- package/package.json +113 -113
- package/scripts/generate-component-schema.js +82 -79
- package/styles/africanity.css +321 -321
- package/styles/typography.css +140 -140
- package/templates/starter/.env.example +15 -15
- package/templates/starter/africode.config.js +40 -40
- package/templates/starter/package.json +13 -13
- package/templates/starter/src/index.js +18 -18
- package/templates/starter/src/pages/index.html +55 -55
- package/templates/starter/src/pages/index.js +17 -17
- package/templates/starter/src/styles/main.css +3 -3
- package/templates/starter-3d/.env.example +7 -7
- package/templates/starter-3d/africode.config.js +29 -29
- package/templates/starter-3d/components/af-model-viewer.js +125 -125
- package/templates/starter-3d/package.json +14 -14
- package/templates/starter-3d/src/pages/index.html +55 -55
- package/templates/starter-3d/src/pages/index.js +50 -50
- package/templates/starter-3d/src/styles/main.css +3 -3
- package/templates/starter-dashboard/.env.example +21 -21
- package/templates/starter-dashboard/africode.config.js +20 -20
- package/templates/starter-dashboard/package.json +14 -14
- package/templates/starter-dashboard/src/index.js +17 -17
- package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
- package/templates/starter-dashboard/src/pages/index.html +118 -118
- package/templates/starter-dashboard/src/pages/index.js +110 -110
- package/templates/starter-dashboard/src/styles/main.css +172 -172
- package/templates/starter-fintech/.env.example +28 -28
- package/templates/starter-fintech/africode.config.js +20 -20
- package/templates/starter-fintech/package.json +15 -15
- package/templates/starter-fintech/src/index.js +17 -17
- package/templates/starter-fintech/src/pages/api/auth.js +45 -45
- package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
- package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
- package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
- package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
- package/templates/starter-fintech/src/pages/index.html +169 -169
- package/templates/starter-fintech/src/pages/index.js +161 -161
- package/templates/starter-fintech/src/styles/main.css +246 -246
- package/templates/starter-react/.env.example +15 -15
- package/templates/starter-react/africode.config.js +40 -40
- package/templates/starter-react/package.json +15 -15
- package/templates/starter-react/src/pages/index.html +55 -55
- package/templates/starter-react/src/pages/index.js +68 -68
- package/templates/starter-react/src/styles/main.css +3 -3
- package/templates/starter-tailwind/.env.example +15 -15
- package/templates/starter-tailwind/africode.config.js +40 -40
- package/templates/starter-tailwind/package.json +19 -19
- package/templates/starter-tailwind/src/pages/index.html +55 -55
- package/templates/starter-tailwind/src/pages/index.js +67 -67
- package/templates/starter-tailwind/src/styles/main.css +3 -3
- package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
- package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
- package/templates/starter-tailwind/tailwind.config.cjs +18 -18
- package/templates/starter-website/.env.example +18 -18
- package/templates/starter-website/africode.config.js +20 -20
- package/templates/starter-website/package.json +14 -14
- package/templates/starter-website/src/index.js +17 -17
- package/templates/starter-website/src/pages/index.html +124 -124
- package/templates/starter-website/src/pages/index.js +116 -116
- package/templates/starter-website/src/styles/main.css +195 -195
- package/bin/africode.js.1758507140 +0 -343
- package/core/heartbeat.js +0 -64
package/core/validation.d.ts
CHANGED
|
@@ -1,233 +1,233 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* AfriCode Validation System Type Definitions
|
|
3
|
-
*
|
|
4
|
-
* Philosophy: Strict by default. Convenient by composition. Secure early.
|
|
5
|
-
*
|
|
6
|
-
* TypeScript definitions for Zod-based validation schemas, AfriFieldBuilder,
|
|
7
|
-
* afri namespace, and normalizeInput utility.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import { z } from 'zod';
|
|
11
|
-
|
|
12
|
-
// ─────────────────────────────────────────────────────────────
|
|
13
|
-
// Result Types
|
|
14
|
-
// ─────────────────────────────────────────────────────────────
|
|
15
|
-
|
|
16
|
-
export interface ValidationResult<T = any> {
|
|
17
|
-
success: boolean;
|
|
18
|
-
data?: T;
|
|
19
|
-
errors?: Record<string, string>;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
export interface FieldValidationResult {
|
|
23
|
-
success: boolean;
|
|
24
|
-
error?: string;
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
// ─────────────────────────────────────────────────────────────
|
|
28
|
-
// Schemas
|
|
29
|
-
// ─────────────────────────────────────────────────────────────
|
|
30
|
-
|
|
31
|
-
export interface ValidationSchemas {
|
|
32
|
-
login: z.ZodObject<{
|
|
33
|
-
email: z.ZodString;
|
|
34
|
-
password: z.ZodString;
|
|
35
|
-
}>;
|
|
36
|
-
|
|
37
|
-
register: z.ZodObject<{
|
|
38
|
-
name: z.ZodString;
|
|
39
|
-
email: z.ZodString;
|
|
40
|
-
password: z.ZodString;
|
|
41
|
-
confirmPassword: z.ZodString;
|
|
42
|
-
}>;
|
|
43
|
-
|
|
44
|
-
contact: z.ZodObject<{
|
|
45
|
-
name: z.ZodString;
|
|
46
|
-
email: z.ZodString;
|
|
47
|
-
message: z.ZodString;
|
|
48
|
-
}>;
|
|
49
|
-
|
|
50
|
-
/** User profile update — avatar_url is a strict URL, nullable */
|
|
51
|
-
userProfile: z.ZodObject<{
|
|
52
|
-
full_name: z.ZodOptional<z.ZodString>;
|
|
53
|
-
bio: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
54
|
-
avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
55
|
-
theme: z.ZodOptional<z.ZodEnum<['africanity', 'dark', 'light', 'system']>>;
|
|
56
|
-
language: z.ZodOptional<z.ZodString>;
|
|
57
|
-
}>;
|
|
58
|
-
|
|
59
|
-
/** Project creation/update — repository_url, demo_url are strict URLs, nullable */
|
|
60
|
-
project: z.ZodObject<{
|
|
61
|
-
name: z.ZodString;
|
|
62
|
-
description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
63
|
-
repository_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
64
|
-
demo_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
65
|
-
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
66
|
-
is_public: z.ZodOptional<z.ZodBoolean>;
|
|
67
|
-
}>;
|
|
68
|
-
|
|
69
|
-
email: z.ZodString;
|
|
70
|
-
password: z.ZodString;
|
|
71
|
-
phone: z.ZodString;
|
|
72
|
-
url: z.ZodString;
|
|
73
|
-
required: z.ZodString;
|
|
74
|
-
positiveNumber: z.ZodNumber;
|
|
75
|
-
integer: z.ZodNumber;
|
|
76
|
-
futureDate: z.ZodDate;
|
|
77
|
-
imageFile: z.ZodType<File>;
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
// ─────────────────────────────────────────────────────────────
|
|
81
|
-
// Validation Class
|
|
82
|
-
// ─────────────────────────────────────────────────────────────
|
|
83
|
-
|
|
84
|
-
export declare class Validation {
|
|
85
|
-
static validate<T>(
|
|
86
|
-
schema: z.ZodSchema<T>,
|
|
87
|
-
data: unknown
|
|
88
|
-
): ValidationResult<T>;
|
|
89
|
-
|
|
90
|
-
static validateField(
|
|
91
|
-
schema: z.ZodSchema,
|
|
92
|
-
value: unknown
|
|
93
|
-
): FieldValidationResult;
|
|
94
|
-
|
|
95
|
-
static getFieldError(
|
|
96
|
-
validationResult: ValidationResult,
|
|
97
|
-
fieldPath: string
|
|
98
|
-
): string | null;
|
|
99
|
-
|
|
100
|
-
static hasFieldError(
|
|
101
|
-
validationResult: ValidationResult,
|
|
102
|
-
fieldPath: string
|
|
103
|
-
): boolean;
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
// ─────────────────────────────────────────────────────────────
|
|
107
|
-
// Rules
|
|
108
|
-
// ─────────────────────────────────────────────────────────────
|
|
109
|
-
|
|
110
|
-
export interface ValidationRules {
|
|
111
|
-
required: (message?: string) => z.ZodString;
|
|
112
|
-
email: (message?: string) => z.ZodString;
|
|
113
|
-
minLength: (min: number, message?: string) => z.ZodString;
|
|
114
|
-
maxLength: (max: number, message?: string) => z.ZodString;
|
|
115
|
-
pattern: (regex: RegExp, message: string) => z.ZodString;
|
|
116
|
-
numeric: (message?: string) => z.ZodString;
|
|
117
|
-
phone: (message?: string) => z.ZodString;
|
|
118
|
-
url: (message?: string) => z.ZodString;
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
// ─────────────────────────────────────────────────────────────
|
|
122
|
-
// AfriFieldBuilder — Chainable field schema builder
|
|
123
|
-
//
|
|
124
|
-
// Strict by default. Convenient by composition.
|
|
125
|
-
// ─────────────────────────────────────────────────────────────
|
|
126
|
-
|
|
127
|
-
export interface AfriFieldMeta {
|
|
128
|
-
fieldType: string;
|
|
129
|
-
isNullable: boolean;
|
|
130
|
-
isOptional: boolean;
|
|
131
|
-
emptyAsNull: boolean;
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
/**
|
|
135
|
-
* Chainable field builder for AfriCode validation schemas.
|
|
136
|
-
* Wraps Zod with framework-level semantics.
|
|
137
|
-
*
|
|
138
|
-
* .emptyAsNull() does NOT alter the Zod schema itself.
|
|
139
|
-
* It marks the field for preprocessing via normalizeInput().
|
|
140
|
-
*/
|
|
141
|
-
export declare class AfriFieldBuilder {
|
|
142
|
-
constructor(baseSchema: z.ZodSchema, fieldType?: string);
|
|
143
|
-
|
|
144
|
-
/** Allow null as a valid value */
|
|
145
|
-
nullable(): this;
|
|
146
|
-
|
|
147
|
-
/** Allow undefined (field can be omitted) */
|
|
148
|
-
optional(): this;
|
|
149
|
-
|
|
150
|
-
/**
|
|
151
|
-
* Mark this field for empty-string-to-null conversion.
|
|
152
|
-
* Requires .nullable() to have been called first.
|
|
153
|
-
* The conversion happens in normalizeInput(), not in the Zod schema.
|
|
154
|
-
*/
|
|
155
|
-
emptyAsNull(): this;
|
|
156
|
-
|
|
157
|
-
/** Set a custom error message */
|
|
158
|
-
message(message: string): this;
|
|
159
|
-
|
|
160
|
-
/** Build the final Zod schema */
|
|
161
|
-
build(): z.ZodSchema;
|
|
162
|
-
|
|
163
|
-
/** Get the metadata for this field (used by normalizeInput) */
|
|
164
|
-
getMeta(): AfriFieldMeta;
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
// ─────────────────────────────────────────────────────────────
|
|
168
|
-
// afri namespace — Field factory
|
|
169
|
-
// ─────────────────────────────────────────────────────────────
|
|
170
|
-
|
|
171
|
-
export interface AfriNamespace {
|
|
172
|
-
/** Create a strict URL field builder. Empty strings always rejected at core. */
|
|
173
|
-
url(message?: string): AfriFieldBuilder;
|
|
174
|
-
|
|
175
|
-
/** Create a strict email field builder. */
|
|
176
|
-
email(message?: string): AfriFieldBuilder;
|
|
177
|
-
|
|
178
|
-
/** Create a string field builder. */
|
|
179
|
-
string(opts?: { min?: number; max?: number; message?: string }): AfriFieldBuilder;
|
|
180
|
-
|
|
181
|
-
/** Create a number field builder. */
|
|
182
|
-
number(opts?: { min?: number; max?: number; int?: boolean }): AfriFieldBuilder;
|
|
183
|
-
|
|
184
|
-
/** Create a phone field builder. */
|
|
185
|
-
phone(message?: string): AfriFieldBuilder;
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
export declare const afri: AfriNamespace;
|
|
189
|
-
|
|
190
|
-
// ─────────────────────────────────────────────────────────────
|
|
191
|
-
// Preprocessing Utilities
|
|
192
|
-
// ─────────────────────────────────────────────────────────────
|
|
193
|
-
|
|
194
|
-
/**
|
|
195
|
-
* Normalize input data before validation.
|
|
196
|
-
* Examines field metadata from AfriFieldBuilder instances and applies
|
|
197
|
-
* transformations like converting empty strings to null for .emptyAsNull() fields.
|
|
198
|
-
*
|
|
199
|
-
* Separation of concerns:
|
|
200
|
-
* - normalizeInput() = input adapter (flexible)
|
|
201
|
-
* - Validation.validate() = core validation (strict)
|
|
202
|
-
*/
|
|
203
|
-
export declare function normalizeInput(
|
|
204
|
-
fieldBuilders: Record<string, AfriFieldBuilder>,
|
|
205
|
-
data: Record<string, unknown>
|
|
206
|
-
): Record<string, unknown>;
|
|
207
|
-
|
|
208
|
-
/**
|
|
209
|
-
* Build a Zod object schema from a map of AfriFieldBuilder instances.
|
|
210
|
-
* Convenience method to go from builders → Zod schema in one step.
|
|
211
|
-
*/
|
|
212
|
-
export declare function buildSchema(
|
|
213
|
-
fieldBuilders: Record<string, AfriFieldBuilder | z.ZodSchema>
|
|
214
|
-
): z.ZodObject<any>;
|
|
215
|
-
|
|
216
|
-
// ─────────────────────────────────────────────────────────────
|
|
217
|
-
// Exports
|
|
218
|
-
// ─────────────────────────────────────────────────────────────
|
|
219
|
-
|
|
220
|
-
export declare const schemas: ValidationSchemas;
|
|
221
|
-
export declare const rules: ValidationRules;
|
|
222
|
-
|
|
223
|
-
declare const validation: {
|
|
224
|
-
schemas: ValidationSchemas;
|
|
225
|
-
Validation: typeof Validation;
|
|
226
|
-
rules: ValidationRules;
|
|
227
|
-
afri: AfriNamespace;
|
|
228
|
-
AfriFieldBuilder: typeof AfriFieldBuilder;
|
|
229
|
-
normalizeInput: typeof normalizeInput;
|
|
230
|
-
buildSchema: typeof buildSchema;
|
|
231
|
-
};
|
|
232
|
-
|
|
1
|
+
/**
|
|
2
|
+
* AfriCode Validation System Type Definitions
|
|
3
|
+
*
|
|
4
|
+
* Philosophy: Strict by default. Convenient by composition. Secure early.
|
|
5
|
+
*
|
|
6
|
+
* TypeScript definitions for Zod-based validation schemas, AfriFieldBuilder,
|
|
7
|
+
* afri namespace, and normalizeInput utility.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import { z } from 'zod';
|
|
11
|
+
|
|
12
|
+
// ─────────────────────────────────────────────────────────────
|
|
13
|
+
// Result Types
|
|
14
|
+
// ─────────────────────────────────────────────────────────────
|
|
15
|
+
|
|
16
|
+
export interface ValidationResult<T = any> {
|
|
17
|
+
success: boolean;
|
|
18
|
+
data?: T;
|
|
19
|
+
errors?: Record<string, string>;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface FieldValidationResult {
|
|
23
|
+
success: boolean;
|
|
24
|
+
error?: string;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
// ─────────────────────────────────────────────────────────────
|
|
28
|
+
// Schemas
|
|
29
|
+
// ─────────────────────────────────────────────────────────────
|
|
30
|
+
|
|
31
|
+
export interface ValidationSchemas {
|
|
32
|
+
login: z.ZodObject<{
|
|
33
|
+
email: z.ZodString;
|
|
34
|
+
password: z.ZodString;
|
|
35
|
+
}>;
|
|
36
|
+
|
|
37
|
+
register: z.ZodObject<{
|
|
38
|
+
name: z.ZodString;
|
|
39
|
+
email: z.ZodString;
|
|
40
|
+
password: z.ZodString;
|
|
41
|
+
confirmPassword: z.ZodString;
|
|
42
|
+
}>;
|
|
43
|
+
|
|
44
|
+
contact: z.ZodObject<{
|
|
45
|
+
name: z.ZodString;
|
|
46
|
+
email: z.ZodString;
|
|
47
|
+
message: z.ZodString;
|
|
48
|
+
}>;
|
|
49
|
+
|
|
50
|
+
/** User profile update — avatar_url is a strict URL, nullable */
|
|
51
|
+
userProfile: z.ZodObject<{
|
|
52
|
+
full_name: z.ZodOptional<z.ZodString>;
|
|
53
|
+
bio: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
54
|
+
avatar_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
55
|
+
theme: z.ZodOptional<z.ZodEnum<['africanity', 'dark', 'light', 'system']>>;
|
|
56
|
+
language: z.ZodOptional<z.ZodString>;
|
|
57
|
+
}>;
|
|
58
|
+
|
|
59
|
+
/** Project creation/update — repository_url, demo_url are strict URLs, nullable */
|
|
60
|
+
project: z.ZodObject<{
|
|
61
|
+
name: z.ZodString;
|
|
62
|
+
description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
63
|
+
repository_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
64
|
+
demo_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
65
|
+
tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
66
|
+
is_public: z.ZodOptional<z.ZodBoolean>;
|
|
67
|
+
}>;
|
|
68
|
+
|
|
69
|
+
email: z.ZodString;
|
|
70
|
+
password: z.ZodString;
|
|
71
|
+
phone: z.ZodString;
|
|
72
|
+
url: z.ZodString;
|
|
73
|
+
required: z.ZodString;
|
|
74
|
+
positiveNumber: z.ZodNumber;
|
|
75
|
+
integer: z.ZodNumber;
|
|
76
|
+
futureDate: z.ZodDate;
|
|
77
|
+
imageFile: z.ZodType<File>;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// ─────────────────────────────────────────────────────────────
|
|
81
|
+
// Validation Class
|
|
82
|
+
// ─────────────────────────────────────────────────────────────
|
|
83
|
+
|
|
84
|
+
export declare class Validation {
|
|
85
|
+
static validate<T>(
|
|
86
|
+
schema: z.ZodSchema<T>,
|
|
87
|
+
data: unknown
|
|
88
|
+
): ValidationResult<T>;
|
|
89
|
+
|
|
90
|
+
static validateField(
|
|
91
|
+
schema: z.ZodSchema,
|
|
92
|
+
value: unknown
|
|
93
|
+
): FieldValidationResult;
|
|
94
|
+
|
|
95
|
+
static getFieldError(
|
|
96
|
+
validationResult: ValidationResult,
|
|
97
|
+
fieldPath: string
|
|
98
|
+
): string | null;
|
|
99
|
+
|
|
100
|
+
static hasFieldError(
|
|
101
|
+
validationResult: ValidationResult,
|
|
102
|
+
fieldPath: string
|
|
103
|
+
): boolean;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
// ─────────────────────────────────────────────────────────────
|
|
107
|
+
// Rules
|
|
108
|
+
// ─────────────────────────────────────────────────────────────
|
|
109
|
+
|
|
110
|
+
export interface ValidationRules {
|
|
111
|
+
required: (message?: string) => z.ZodString;
|
|
112
|
+
email: (message?: string) => z.ZodString;
|
|
113
|
+
minLength: (min: number, message?: string) => z.ZodString;
|
|
114
|
+
maxLength: (max: number, message?: string) => z.ZodString;
|
|
115
|
+
pattern: (regex: RegExp, message: string) => z.ZodString;
|
|
116
|
+
numeric: (message?: string) => z.ZodString;
|
|
117
|
+
phone: (message?: string) => z.ZodString;
|
|
118
|
+
url: (message?: string) => z.ZodString;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// ─────────────────────────────────────────────────────────────
|
|
122
|
+
// AfriFieldBuilder — Chainable field schema builder
|
|
123
|
+
//
|
|
124
|
+
// Strict by default. Convenient by composition.
|
|
125
|
+
// ─────────────────────────────────────────────────────────────
|
|
126
|
+
|
|
127
|
+
export interface AfriFieldMeta {
|
|
128
|
+
fieldType: string;
|
|
129
|
+
isNullable: boolean;
|
|
130
|
+
isOptional: boolean;
|
|
131
|
+
emptyAsNull: boolean;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Chainable field builder for AfriCode validation schemas.
|
|
136
|
+
* Wraps Zod with framework-level semantics.
|
|
137
|
+
*
|
|
138
|
+
* .emptyAsNull() does NOT alter the Zod schema itself.
|
|
139
|
+
* It marks the field for preprocessing via normalizeInput().
|
|
140
|
+
*/
|
|
141
|
+
export declare class AfriFieldBuilder {
|
|
142
|
+
constructor(baseSchema: z.ZodSchema, fieldType?: string);
|
|
143
|
+
|
|
144
|
+
/** Allow null as a valid value */
|
|
145
|
+
nullable(): this;
|
|
146
|
+
|
|
147
|
+
/** Allow undefined (field can be omitted) */
|
|
148
|
+
optional(): this;
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* Mark this field for empty-string-to-null conversion.
|
|
152
|
+
* Requires .nullable() to have been called first.
|
|
153
|
+
* The conversion happens in normalizeInput(), not in the Zod schema.
|
|
154
|
+
*/
|
|
155
|
+
emptyAsNull(): this;
|
|
156
|
+
|
|
157
|
+
/** Set a custom error message */
|
|
158
|
+
message(message: string): this;
|
|
159
|
+
|
|
160
|
+
/** Build the final Zod schema */
|
|
161
|
+
build(): z.ZodSchema;
|
|
162
|
+
|
|
163
|
+
/** Get the metadata for this field (used by normalizeInput) */
|
|
164
|
+
getMeta(): AfriFieldMeta;
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
// ─────────────────────────────────────────────────────────────
|
|
168
|
+
// afri namespace — Field factory
|
|
169
|
+
// ─────────────────────────────────────────────────────────────
|
|
170
|
+
|
|
171
|
+
export interface AfriNamespace {
|
|
172
|
+
/** Create a strict URL field builder. Empty strings always rejected at core. */
|
|
173
|
+
url(message?: string): AfriFieldBuilder;
|
|
174
|
+
|
|
175
|
+
/** Create a strict email field builder. */
|
|
176
|
+
email(message?: string): AfriFieldBuilder;
|
|
177
|
+
|
|
178
|
+
/** Create a string field builder. */
|
|
179
|
+
string(opts?: { min?: number; max?: number; message?: string }): AfriFieldBuilder;
|
|
180
|
+
|
|
181
|
+
/** Create a number field builder. */
|
|
182
|
+
number(opts?: { min?: number; max?: number; int?: boolean }): AfriFieldBuilder;
|
|
183
|
+
|
|
184
|
+
/** Create a phone field builder. */
|
|
185
|
+
phone(message?: string): AfriFieldBuilder;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
export declare const afri: AfriNamespace;
|
|
189
|
+
|
|
190
|
+
// ─────────────────────────────────────────────────────────────
|
|
191
|
+
// Preprocessing Utilities
|
|
192
|
+
// ─────────────────────────────────────────────────────────────
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* Normalize input data before validation.
|
|
196
|
+
* Examines field metadata from AfriFieldBuilder instances and applies
|
|
197
|
+
* transformations like converting empty strings to null for .emptyAsNull() fields.
|
|
198
|
+
*
|
|
199
|
+
* Separation of concerns:
|
|
200
|
+
* - normalizeInput() = input adapter (flexible)
|
|
201
|
+
* - Validation.validate() = core validation (strict)
|
|
202
|
+
*/
|
|
203
|
+
export declare function normalizeInput(
|
|
204
|
+
fieldBuilders: Record<string, AfriFieldBuilder>,
|
|
205
|
+
data: Record<string, unknown>
|
|
206
|
+
): Record<string, unknown>;
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* Build a Zod object schema from a map of AfriFieldBuilder instances.
|
|
210
|
+
* Convenience method to go from builders → Zod schema in one step.
|
|
211
|
+
*/
|
|
212
|
+
export declare function buildSchema(
|
|
213
|
+
fieldBuilders: Record<string, AfriFieldBuilder | z.ZodSchema>
|
|
214
|
+
): z.ZodObject<any>;
|
|
215
|
+
|
|
216
|
+
// ─────────────────────────────────────────────────────────────
|
|
217
|
+
// Exports
|
|
218
|
+
// ─────────────────────────────────────────────────────────────
|
|
219
|
+
|
|
220
|
+
export declare const schemas: ValidationSchemas;
|
|
221
|
+
export declare const rules: ValidationRules;
|
|
222
|
+
|
|
223
|
+
declare const validation: {
|
|
224
|
+
schemas: ValidationSchemas;
|
|
225
|
+
Validation: typeof Validation;
|
|
226
|
+
rules: ValidationRules;
|
|
227
|
+
afri: AfriNamespace;
|
|
228
|
+
AfriFieldBuilder: typeof AfriFieldBuilder;
|
|
229
|
+
normalizeInput: typeof normalizeInput;
|
|
230
|
+
buildSchema: typeof buildSchema;
|
|
231
|
+
};
|
|
232
|
+
|
|
233
233
|
export default validation;
|