@objectstack/spec 0.1.2 → 0.2.0

package/json-schema/AuthConfig.json

@@ -0,0 +1,606 @@
+{
+  "$ref": "#/definitions/AuthConfig",
+  "definitions": {
+    "AuthConfig": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z_][a-z0-9_]*$",
+          "description": "Configuration name (snake_case)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Display label"
+        },
+        "driver": {
+          "type": "string",
+          "default": "better-auth",
+          "description": "The underlying authentication implementation driver"
+        },
+        "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/AuthPluginConfig.json

@@ -0,0 +1,28 @@
+{
+  "$ref": "#/definitions/AuthPluginConfig",
+  "definitions": {
+    "AuthPluginConfig": {
+      "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
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/json-schema/AuthStrategy.json

@@ -0,0 +1,17 @@
+{
+  "$ref": "#/definitions/AuthStrategy",
+  "definitions": {
+    "AuthStrategy": {
+      "type": "string",
+      "enum": [
+        "email_password",
+        "magic_link",
+        "oauth",
+        "passkey",
+        "otp",
+        "anonymous"
+      ]
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}