@objectstack/spec 0.1.2 → 0.3.0

package/json-schema/AuthenticationProvider.json

@@ -0,0 +1,617 @@
+{
+  "$ref": "#/definitions/AuthenticationProvider",
+  "definitions": {
+    "AuthenticationProvider": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "authentication",
+          "description": "Provider type identifier"
+        },
+        "config": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string",
+              "pattern": "^[a-z_][a-z0-9_]*$",
+              "description": "Configuration name (snake_case)"
+            },
+            "label": {
+              "type": "string",
+              "description": "Display label"
+            },
+            "strategies": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "email_password",
+                  "magic_link",
+                  "oauth",
+                  "passkey",
+                  "otp",
+                  "anonymous"
+                ]
+              },
+              "minItems": 1,
+              "description": "Enabled authentication strategies"
+            },
+            "baseUrl": {
+              "type": "string",
+              "format": "uri",
+              "description": "Application base URL"
+            },
+            "secret": {
+              "type": "string",
+              "minLength": 32,
+              "description": "Secret key for signing (min 32 chars)"
+            },
+            "emailPassword": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "requireEmailVerification": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Require email verification before login"
+                },
+                "minPasswordLength": {
+                  "type": "number",
+                  "minimum": 6,
+                  "maximum": 128,
+                  "default": 8,
+                  "description": "Minimum password length"
+                },
+                "requirePasswordComplexity": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Require uppercase, lowercase, numbers, symbols"
+                },
+                "allowPasswordReset": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable password reset functionality"
+                },
+                "passwordResetExpiry": {
+                  "type": "number",
+                  "default": 3600,
+                  "description": "Password reset token expiry in seconds"
+                }
+              },
+              "additionalProperties": false
+            },
+            "magicLink": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "expiryTime": {
+                  "type": "number",
+                  "default": 900,
+                  "description": "Magic link expiry time in seconds (default 15 min)"
+                }
+              },
+              "additionalProperties": false
+            },
+            "passkey": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "rpName": {
+                  "type": "string",
+                  "description": "Relying Party name"
+                },
+                "rpId": {
+                  "type": "string",
+                  "description": "Relying Party ID (defaults to domain)"
+                },
+                "allowedOrigins": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "format": "uri"
+                  },
+                  "description": "Allowed origins for WebAuthn"
+                },
+                "userVerification": {
+                  "type": "string",
+                  "enum": [
+                    "required",
+                    "preferred",
+                    "discouraged"
+                  ],
+                  "default": "preferred"
+                },
+                "attestation": {
+                  "type": "string",
+                  "enum": [
+                    "none",
+                    "indirect",
+                    "direct",
+                    "enterprise"
+                  ],
+                  "default": "none"
+                }
+              },
+              "required": [
+                "rpName"
+              ],
+              "additionalProperties": false
+            },
+            "oauth": {
+              "type": "object",
+              "properties": {
+                "providers": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "provider": {
+                        "type": "string",
+                        "enum": [
+                          "google",
+                          "github",
+                          "facebook",
+                          "twitter",
+                          "linkedin",
+                          "microsoft",
+                          "apple",
+                          "discord",
+                          "gitlab",
+                          "custom"
+                        ],
+                        "description": "OAuth provider type"
+                      },
+                      "clientId": {
+                        "type": "string",
+                        "description": "OAuth client ID"
+                      },
+                      "clientSecret": {
+                        "type": "string",
+                        "description": "OAuth client secret (typically from ENV)"
+                      },
+                      "scopes": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Requested OAuth scopes"
+                      },
+                      "redirectUri": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "OAuth callback URL"
+                      },
+                      "enabled": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "Whether this provider is enabled"
+                      },
+                      "displayName": {
+                        "type": "string",
+                        "description": "Display name for the provider button"
+                      },
+                      "icon": {
+                        "type": "string",
+                        "description": "Icon URL or identifier"
+                      }
+                    },
+                    "required": [
+                      "provider",
+                      "clientId",
+                      "clientSecret"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "minItems": 1
+                }
+              },
+              "required": [
+                "providers"
+              ],
+              "additionalProperties": false
+            },
+            "session": {
+              "type": "object",
+              "properties": {
+                "expiresIn": {
+                  "type": "number",
+                  "default": 604800,
+                  "description": "Session expiry in seconds (default 7 days)"
+                },
+                "updateAge": {
+                  "type": "number",
+                  "default": 86400,
+                  "description": "Session update interval in seconds (default 1 day)"
+                },
+                "cookieName": {
+                  "type": "string",
+                  "default": "session_token",
+                  "description": "Session cookie name"
+                },
+                "cookieSecure": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Use secure cookies (HTTPS only)"
+                },
+                "cookieSameSite": {
+                  "type": "string",
+                  "enum": [
+                    "strict",
+                    "lax",
+                    "none"
+                  ],
+                  "default": "lax",
+                  "description": "SameSite cookie attribute"
+                },
+                "cookieDomain": {
+                  "type": "string",
+                  "description": "Cookie domain"
+                },
+                "cookiePath": {
+                  "type": "string",
+                  "default": "/",
+                  "description": "Cookie path"
+                },
+                "cookieHttpOnly": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "HttpOnly cookie attribute"
+                }
+              },
+              "additionalProperties": false,
+              "default": {}
+            },
+            "rateLimit": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "maxAttempts": {
+                  "type": "number",
+                  "default": 5,
+                  "description": "Maximum login attempts"
+                },
+                "windowMs": {
+                  "type": "number",
+                  "default": 900000,
+                  "description": "Time window in milliseconds (default 15 min)"
+                },
+                "blockDuration": {
+                  "type": "number",
+                  "default": 900000,
+                  "description": "Block duration after max attempts in ms"
+                },
+                "skipSuccessfulRequests": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Only count failed requests"
+                }
+              },
+              "additionalProperties": false,
+              "default": {}
+            },
+            "csrf": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "tokenLength": {
+                  "type": "number",
+                  "default": 32,
+                  "description": "CSRF token length"
+                },
+                "cookieName": {
+                  "type": "string",
+                  "default": "csrf_token",
+                  "description": "CSRF cookie name"
+                },
+                "headerName": {
+                  "type": "string",
+                  "default": "X-CSRF-Token",
+                  "description": "CSRF header name"
+                }
+              },
+              "additionalProperties": false,
+              "default": {}
+            },
+            "accountLinking": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Allow account linking"
+                },
+                "autoLink": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Automatically link accounts with same email"
+                },
+                "requireVerification": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Require email verification before linking"
+                }
+              },
+              "additionalProperties": false,
+              "default": {}
+            },
+            "twoFactor": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "issuer": {
+                  "type": "string",
+                  "description": "TOTP issuer name"
+                },
+                "qrCodeSize": {
+                  "type": "number",
+                  "default": 200,
+                  "description": "QR code size in pixels"
+                },
+                "backupCodes": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "default": true
+                    },
+                    "count": {
+                      "type": "number",
+                      "default": 10,
+                      "description": "Number of backup codes to generate"
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
+            },
+            "userFieldMapping": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "default": "id",
+                  "description": "User ID field"
+                },
+                "email": {
+                  "type": "string",
+                  "default": "email",
+                  "description": "Email field"
+                },
+                "name": {
+                  "type": "string",
+                  "default": "name",
+                  "description": "Name field"
+                },
+                "image": {
+                  "type": "string",
+                  "default": "image",
+                  "description": "Profile image field"
+                },
+                "emailVerified": {
+                  "type": "string",
+                  "default": "email_verified",
+                  "description": "Email verification status field"
+                },
+                "createdAt": {
+                  "type": "string",
+                  "default": "created_at",
+                  "description": "Created timestamp field"
+                },
+                "updatedAt": {
+                  "type": "string",
+                  "default": "updated_at",
+                  "description": "Updated timestamp field"
+                }
+              },
+              "additionalProperties": false,
+              "default": {}
+            },
+            "database": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "prisma",
+                    "drizzle",
+                    "kysely",
+                    "custom"
+                  ],
+                  "description": "Database adapter type"
+                },
+                "connectionString": {
+                  "type": "string",
+                  "description": "Database connection string"
+                },
+                "tablePrefix": {
+                  "type": "string",
+                  "default": "auth_",
+                  "description": "Prefix for auth tables"
+                },
+                "schema": {
+                  "type": "string",
+                  "description": "Database schema name"
+                }
+              },
+              "required": [
+                "type"
+              ],
+              "additionalProperties": false
+            },
+            "plugins": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Plugin name"
+                  },
+                  "enabled": {
+                    "type": "boolean",
+                    "default": true
+                  },
+                  "options": {
+                    "type": "object",
+                    "additionalProperties": {},
+                    "description": "Plugin-specific options"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              },
+              "default": []
+            },
+            "hooks": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": false,
+              "description": "Authentication lifecycle hooks"
+            },
+            "security": {
+              "type": "object",
+              "properties": {
+                "allowedOrigins": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "CORS allowed origins"
+                },
+                "trustProxy": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Trust proxy headers"
+                },
+                "ipRateLimiting": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable IP-based rate limiting"
+                },
+                "sessionFingerprinting": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Enable session fingerprinting"
+                },
+                "maxSessions": {
+                  "type": "number",
+                  "default": 5,
+                  "description": "Maximum concurrent sessions per user"
+                }
+              },
+              "additionalProperties": false,
+              "description": "Advanced security settings"
+            },
+            "email": {
+              "type": "object",
+              "properties": {
+                "from": {
+                  "type": "string",
+                  "format": "email",
+                  "description": "From email address"
+                },
+                "fromName": {
+                  "type": "string",
+                  "description": "From name"
+                },
+                "provider": {
+                  "type": "string",
+                  "enum": [
+                    "smtp",
+                    "sendgrid",
+                    "mailgun",
+                    "ses",
+                    "resend",
+                    "custom"
+                  ],
+                  "description": "Email provider"
+                },
+                "config": {
+                  "type": "object",
+                  "additionalProperties": {},
+                  "description": "Provider-specific configuration"
+                }
+              },
+              "required": [
+                "from",
+                "provider"
+              ],
+              "additionalProperties": false,
+              "description": "Email configuration"
+            },
+            "ui": {
+              "type": "object",
+              "properties": {
+                "brandName": {
+                  "type": "string",
+                  "description": "Brand name displayed in auth UI"
+                },
+                "logo": {
+                  "type": "string",
+                  "description": "Logo URL"
+                },
+                "primaryColor": {
+                  "type": "string",
+                  "description": "Primary brand color (hex)"
+                },
+                "customCss": {
+                  "type": "string",
+                  "description": "Custom CSS for auth pages"
+                }
+              },
+              "additionalProperties": false,
+              "description": "UI customization"
+            },
+            "active": {
+              "type": "boolean",
+              "default": true,
+              "description": "Whether this provider is active"
+            },
+            "allowRegistration": {
+              "type": "boolean",
+              "default": true,
+              "description": "Allow new user registration"
+            }
+          },
+          "required": [
+            "name",
+            "label",
+            "strategies",
+            "baseUrl",
+            "secret"
+          ],
+          "additionalProperties": false,
+          "description": "Authentication configuration"
+        }
+      },
+      "required": [
+        "type",
+        "config"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/CSRFConfig.json

@@ -0,0 +1,31 @@
+{
+  "$ref": "#/definitions/CSRFConfig",
+  "definitions": {
+    "CSRFConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "tokenLength": {
+          "type": "number",
+          "default": 32,
+          "description": "CSRF token length"
+        },
+        "cookieName": {
+          "type": "string",
+          "default": "csrf_token",
+          "description": "CSRF cookie name"
+        },
+        "headerName": {
+          "type": "string",
+          "default": "X-CSRF-Token",
+          "description": "CSRF header name"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}