@spfn/auth 0.1.0-alpha.0 → 0.1.0-alpha.1

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 (67) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +70 -12
  3. package/dist/api-BcQM4WKb.d.ts +45 -0
  4. package/dist/client.d.ts +2 -0
  5. package/dist/client.js +1 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/index.d.ts +57 -0
  8. package/dist/index.js +8966 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/lib/contracts/auth.d.ts +262 -0
  11. package/dist/lib/contracts/auth.js +2923 -0
  12. package/dist/lib/contracts/auth.js.map +1 -0
  13. package/dist/lib/contracts/index.d.ts +3 -0
  14. package/dist/lib/contracts/index.js +3162 -0
  15. package/dist/lib/contracts/index.js.map +1 -0
  16. package/dist/lib/contracts/invitation.d.ts +243 -0
  17. package/dist/lib/contracts/invitation.js +2883 -0
  18. package/dist/lib/contracts/invitation.js.map +1 -0
  19. package/dist/plugin.d.ts +12 -0
  20. package/dist/plugin.js +8949 -0
  21. package/dist/plugin.js.map +1 -0
  22. package/dist/server/entities/index.d.ts +10 -0
  23. package/dist/server/entities/index.js +399 -0
  24. package/dist/server/entities/index.js.map +1 -0
  25. package/dist/server/entities/invitations.d.ts +241 -0
  26. package/dist/server/entities/invitations.js +181 -0
  27. package/dist/server/entities/invitations.js.map +1 -0
  28. package/dist/server/entities/permissions.d.ts +196 -0
  29. package/dist/server/entities/permissions.js +44 -0
  30. package/dist/server/entities/permissions.js.map +1 -0
  31. package/dist/server/entities/role-permissions.d.ts +107 -0
  32. package/dist/server/entities/role-permissions.js +112 -0
  33. package/dist/server/entities/role-permissions.js.map +1 -0
  34. package/dist/server/entities/roles.d.ts +196 -0
  35. package/dist/server/entities/roles.js +45 -0
  36. package/dist/server/entities/roles.js.map +1 -0
  37. package/dist/server/entities/user-permissions.d.ts +163 -0
  38. package/dist/server/entities/user-permissions.js +191 -0
  39. package/dist/server/entities/user-permissions.js.map +1 -0
  40. package/dist/server/entities/user-public-keys.d.ts +227 -0
  41. package/dist/server/entities/user-public-keys.js +153 -0
  42. package/dist/server/entities/user-public-keys.js.map +1 -0
  43. package/dist/server/entities/user-social-accounts.d.ts +189 -0
  44. package/dist/server/entities/user-social-accounts.js +146 -0
  45. package/dist/server/entities/user-social-accounts.js.map +1 -0
  46. package/dist/server/entities/users.d.ts +235 -0
  47. package/dist/server/entities/users.js +113 -0
  48. package/dist/server/entities/users.js.map +1 -0
  49. package/dist/server/entities/verification-codes.d.ts +191 -0
  50. package/dist/server/entities/verification-codes.js +44 -0
  51. package/dist/server/entities/verification-codes.js.map +1 -0
  52. package/dist/server/routes/auth/index.d.ts +10 -0
  53. package/dist/server/routes/auth/index.js +4475 -0
  54. package/dist/server/routes/auth/index.js.map +1 -0
  55. package/dist/server/routes/index.d.ts +6 -0
  56. package/dist/server/routes/index.js +6352 -0
  57. package/dist/server/routes/index.js.map +1 -0
  58. package/dist/server/routes/invitations/index.d.ts +10 -0
  59. package/dist/server/routes/invitations/index.js +4209 -0
  60. package/dist/server/routes/invitations/index.js.map +1 -0
  61. package/dist/server.d.ts +1243 -0
  62. package/dist/server.js +2281 -0
  63. package/dist/server.js.map +1 -0
  64. package/migrations/0000_tired_gambit.sql +165 -0
  65. package/migrations/meta/0000_snapshot.json +1395 -0
  66. package/migrations/meta/_journal.json +13 -0
  67. package/package.json +32 -24
@@ -0,0 +1,163 @@
1
+ import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
2
+
3
+ /**
4
+ * @spfn/auth - User-Permissions Override Entity
5
+ *
6
+ * Per-user permission grants/revocations
7
+ *
8
+ * Features:
9
+ * - Grant additional permissions to specific users
10
+ * - Revoke role-inherited permissions from specific users
11
+ * - Temporary permissions with expiration
12
+ * - Audit trail with reason field
13
+ *
14
+ * Priority:
15
+ * User permissions override role permissions
16
+ */
17
+ declare const userPermissions: drizzle_orm_pg_core.PgTableWithColumns<{
18
+ name: "user_permissions";
19
+ schema: string;
20
+ columns: {
21
+ createdAt: drizzle_orm_pg_core.PgColumn<{
22
+ name: "created_at";
23
+ tableName: "user_permissions";
24
+ dataType: "date";
25
+ columnType: "PgTimestamp";
26
+ data: Date;
27
+ driverParam: string;
28
+ notNull: true;
29
+ hasDefault: true;
30
+ isPrimaryKey: false;
31
+ isAutoincrement: false;
32
+ hasRuntimeDefault: false;
33
+ enumValues: undefined;
34
+ baseColumn: never;
35
+ identity: undefined;
36
+ generated: undefined;
37
+ }, {}, {}>;
38
+ updatedAt: drizzle_orm_pg_core.PgColumn<{
39
+ name: "updated_at";
40
+ tableName: "user_permissions";
41
+ dataType: "date";
42
+ columnType: "PgTimestamp";
43
+ data: Date;
44
+ driverParam: string;
45
+ notNull: true;
46
+ hasDefault: true;
47
+ isPrimaryKey: false;
48
+ isAutoincrement: false;
49
+ hasRuntimeDefault: false;
50
+ enumValues: undefined;
51
+ baseColumn: never;
52
+ identity: undefined;
53
+ generated: undefined;
54
+ }, {}, {}>;
55
+ id: drizzle_orm_pg_core.PgColumn<{
56
+ name: "id";
57
+ tableName: "user_permissions";
58
+ dataType: "number";
59
+ columnType: "PgBigSerial53";
60
+ data: number;
61
+ driverParam: number;
62
+ notNull: true;
63
+ hasDefault: true;
64
+ isPrimaryKey: true;
65
+ isAutoincrement: false;
66
+ hasRuntimeDefault: false;
67
+ enumValues: undefined;
68
+ baseColumn: never;
69
+ identity: undefined;
70
+ generated: undefined;
71
+ }, {}, {}>;
72
+ userId: drizzle_orm_pg_core.PgColumn<{
73
+ name: "user_id";
74
+ tableName: "user_permissions";
75
+ dataType: "number";
76
+ columnType: "PgBigInt53";
77
+ data: number;
78
+ driverParam: string | number;
79
+ notNull: true;
80
+ hasDefault: false;
81
+ isPrimaryKey: false;
82
+ isAutoincrement: false;
83
+ hasRuntimeDefault: false;
84
+ enumValues: undefined;
85
+ baseColumn: never;
86
+ identity: undefined;
87
+ generated: undefined;
88
+ }, {}, {}>;
89
+ permissionId: drizzle_orm_pg_core.PgColumn<{
90
+ name: "permission_id";
91
+ tableName: "user_permissions";
92
+ dataType: "number";
93
+ columnType: "PgBigInt53";
94
+ data: number;
95
+ driverParam: string | number;
96
+ notNull: true;
97
+ hasDefault: false;
98
+ isPrimaryKey: false;
99
+ isAutoincrement: false;
100
+ hasRuntimeDefault: false;
101
+ enumValues: undefined;
102
+ baseColumn: never;
103
+ identity: undefined;
104
+ generated: undefined;
105
+ }, {}, {}>;
106
+ granted: drizzle_orm_pg_core.PgColumn<{
107
+ name: "granted";
108
+ tableName: "user_permissions";
109
+ dataType: "boolean";
110
+ columnType: "PgBoolean";
111
+ data: boolean;
112
+ driverParam: boolean;
113
+ notNull: true;
114
+ hasDefault: true;
115
+ isPrimaryKey: false;
116
+ isAutoincrement: false;
117
+ hasRuntimeDefault: false;
118
+ enumValues: undefined;
119
+ baseColumn: never;
120
+ identity: undefined;
121
+ generated: undefined;
122
+ }, {}, {}>;
123
+ reason: drizzle_orm_pg_core.PgColumn<{
124
+ name: "reason";
125
+ tableName: "user_permissions";
126
+ dataType: "string";
127
+ columnType: "PgText";
128
+ data: string;
129
+ driverParam: string;
130
+ notNull: false;
131
+ hasDefault: false;
132
+ isPrimaryKey: false;
133
+ isAutoincrement: false;
134
+ hasRuntimeDefault: false;
135
+ enumValues: [string, ...string[]];
136
+ baseColumn: never;
137
+ identity: undefined;
138
+ generated: undefined;
139
+ }, {}, {}>;
140
+ expiresAt: drizzle_orm_pg_core.PgColumn<{
141
+ name: "expires_at";
142
+ tableName: "user_permissions";
143
+ dataType: "date";
144
+ columnType: "PgTimestamp";
145
+ data: Date;
146
+ driverParam: string;
147
+ notNull: false;
148
+ hasDefault: false;
149
+ isPrimaryKey: false;
150
+ isAutoincrement: false;
151
+ hasRuntimeDefault: false;
152
+ enumValues: undefined;
153
+ baseColumn: never;
154
+ identity: undefined;
155
+ generated: undefined;
156
+ }, {}, {}>;
157
+ };
158
+ dialect: "pg";
159
+ }>;
160
+ type UserPermission = typeof userPermissions.$inferSelect;
161
+ type NewUserPermission = typeof userPermissions.$inferInsert;
162
+
163
+ export { type NewUserPermission, type UserPermission, userPermissions };
@@ -0,0 +1,191 @@
1
+ // src/server/entities/user-permissions.ts
2
+ import { bigint as bigint2, boolean as boolean4, text as text4, timestamp as timestamp2, index as index4, unique } from "drizzle-orm/pg-core";
3
+ import { id as id4, timestamps as timestamps4, createFunctionSchema as createFunctionSchema4 } from "@spfn/core/db";
4
+
5
+ // src/server/entities/users.ts
6
+ import { text as text2, timestamp, check, boolean as boolean2, bigint, index as index2 } from "drizzle-orm/pg-core";
7
+ import { id as id2, timestamps as timestamps2, createFunctionSchema as createFunctionSchema2 } from "@spfn/core/db";
8
+ import { sql } from "drizzle-orm";
9
+
10
+ // src/server/entities/roles.ts
11
+ import { text, boolean, integer, index } from "drizzle-orm/pg-core";
12
+ import { id, timestamps, createFunctionSchema } from "@spfn/core/db";
13
+ var schema = createFunctionSchema("@spfn/auth");
14
+ var roles = schema.table(
15
+ "roles",
16
+ {
17
+ // Primary key
18
+ id: id(),
19
+ // Role identifier (used in code, e.g., 'admin', 'editor')
20
+ // Must be unique, lowercase, kebab-case recommended
21
+ name: text("name").notNull().unique(),
22
+ // Display name for UI (e.g., 'Administrator', 'Content Editor')
23
+ displayName: text("display_name").notNull(),
24
+ // Role description
25
+ description: text("description"),
26
+ // Built-in role flag
27
+ // true: Core package roles (user, admin, superadmin) - cannot be deleted
28
+ // false: Custom or preset roles - can be deleted
29
+ isBuiltin: boolean("is_builtin").notNull().default(false),
30
+ // System role flag
31
+ // true: Defined in code (builtin or preset) - deletion restricted
32
+ // false: Runtime created custom role - fully manageable
33
+ isSystem: boolean("is_system").notNull().default(false),
34
+ // Active status
35
+ // false: Deactivated role (users cannot be assigned)
36
+ isActive: boolean("is_active").notNull().default(true),
37
+ // Priority level (higher = more privileged)
38
+ // superadmin: 100, admin: 80, user: 10
39
+ // Used for role hierarchy and conflict resolution
40
+ priority: integer("priority").notNull().default(10),
41
+ ...timestamps()
42
+ },
43
+ (table) => [
44
+ index("roles_name_idx").on(table.name),
45
+ index("roles_is_system_idx").on(table.isSystem),
46
+ index("roles_is_active_idx").on(table.isActive),
47
+ index("roles_is_builtin_idx").on(table.isBuiltin),
48
+ index("roles_priority_idx").on(table.priority)
49
+ ]
50
+ );
51
+
52
+ // src/server/entities/users.ts
53
+ var schema2 = createFunctionSchema2("@spfn/auth");
54
+ var users = schema2.table(
55
+ "users",
56
+ {
57
+ // Identity
58
+ id: id2(),
59
+ // Email address (unique identifier)
60
+ // Used for: login, password reset, notifications
61
+ email: text2("email").unique(),
62
+ // Phone number in E.164 international format
63
+ // Format: +[country code][number] (e.g., +821012345678)
64
+ // Used for: SMS login, 2FA, notifications
65
+ phone: text2("phone").unique(),
66
+ // Authentication
67
+ // Bcrypt password hash ($2b$10$[salt][hash], 60 chars)
68
+ // Nullable to support OAuth-only accounts
69
+ passwordHash: text2("password_hash"),
70
+ // Force password change on next login
71
+ // Use cases: initial setup, security breach, policy violation
72
+ passwordChangeRequired: boolean2("password_change_required").notNull().default(false),
73
+ // Authorization (Role-Based Access Control)
74
+ // Foreign key to roles table
75
+ // References built-in roles: user (default), admin, superadmin
76
+ // Can also reference custom roles created at runtime
77
+ roleId: bigint("role_id", { mode: "number" }).references(() => roles.id).notNull(),
78
+ // Account status
79
+ // - active: Normal operation (default)
80
+ // - inactive: Deactivated (user request, dormant)
81
+ // - suspended: Locked (security incident, ToS violation)
82
+ status: text2(
83
+ "status",
84
+ {
85
+ enum: ["active", "inactive", "suspended"]
86
+ }
87
+ ).notNull().default("active"),
88
+ // Verification timestamps
89
+ // null = unverified, timestamp = verified at this time
90
+ // Email verification (via verification code or magic link)
91
+ emailVerifiedAt: timestamp("email_verified_at", { withTimezone: true }),
92
+ // Phone verification (via SMS OTP)
93
+ phoneVerifiedAt: timestamp("phone_verified_at", { withTimezone: true }),
94
+ // Metadata
95
+ // Last successful login timestamp
96
+ // Used for: security auditing, dormant account detection
97
+ lastLoginAt: timestamp("last_login_at", { withTimezone: true }),
98
+ ...timestamps2()
99
+ },
100
+ (table) => [
101
+ // Database constraints
102
+ // Ensure at least one identifier exists (email OR phone)
103
+ check(
104
+ "email_or_phone_check",
105
+ sql`${table.email} IS NOT NULL OR ${table.phone} IS NOT NULL`
106
+ ),
107
+ // Indexes for query optimization
108
+ index2("users_email_idx").on(table.email),
109
+ index2("users_phone_idx").on(table.phone),
110
+ index2("users_status_idx").on(table.status),
111
+ index2("users_role_id_idx").on(table.roleId)
112
+ ]
113
+ );
114
+
115
+ // src/server/entities/permissions.ts
116
+ import { text as text3, boolean as boolean3, index as index3 } from "drizzle-orm/pg-core";
117
+ import { id as id3, timestamps as timestamps3, createFunctionSchema as createFunctionSchema3 } from "@spfn/core/db";
118
+ var schema3 = createFunctionSchema3("@spfn/auth");
119
+ var permissions = schema3.table(
120
+ "permissions",
121
+ {
122
+ // Primary key
123
+ id: id3(),
124
+ // Permission identifier (e.g., 'user:delete', 'post:publish')
125
+ // Format: resource:action or namespace:resource:action
126
+ // Must be unique
127
+ name: text3("name").notNull().unique(),
128
+ // Display name for UI
129
+ displayName: text3("display_name").notNull(),
130
+ // Permission description
131
+ description: text3("description"),
132
+ // Category for grouping (e.g., 'user', 'post', 'admin', 'system')
133
+ category: text3("category"),
134
+ // Built-in permission flag
135
+ // true: Core package permissions - cannot be deleted
136
+ // false: Custom or preset permissions
137
+ isBuiltin: boolean3("is_builtin").notNull().default(false),
138
+ // System permission flag
139
+ // true: Defined in code (builtin or preset)
140
+ // false: Runtime created custom permission
141
+ isSystem: boolean3("is_system").notNull().default(false),
142
+ // Active status
143
+ // false: Deactivated permission (not enforced)
144
+ isActive: boolean3("is_active").notNull().default(true),
145
+ ...timestamps3()
146
+ },
147
+ (table) => [
148
+ index3("permissions_name_idx").on(table.name),
149
+ index3("permissions_category_idx").on(table.category),
150
+ index3("permissions_is_system_idx").on(table.isSystem),
151
+ index3("permissions_is_active_idx").on(table.isActive),
152
+ index3("permissions_is_builtin_idx").on(table.isBuiltin)
153
+ ]
154
+ );
155
+
156
+ // src/server/entities/user-permissions.ts
157
+ var schema4 = createFunctionSchema4("@spfn/auth");
158
+ var userPermissions = schema4.table(
159
+ "user_permissions",
160
+ {
161
+ // Primary key
162
+ id: id4(),
163
+ // Foreign key to users table
164
+ userId: bigint2("user_id", { mode: "number" }).notNull().references(() => users.id, { onDelete: "cascade" }),
165
+ // Foreign key to permissions table
166
+ permissionId: bigint2("permission_id", { mode: "number" }).notNull().references(() => permissions.id, { onDelete: "cascade" }),
167
+ // Grant or revoke
168
+ // true: Grant this permission (even if role doesn't have it)
169
+ // false: Revoke this permission (even if role has it)
170
+ granted: boolean4("granted").notNull().default(true),
171
+ // Reason for grant/revocation (audit trail)
172
+ reason: text4("reason"),
173
+ // Expiration timestamp (optional)
174
+ // null: Permanent override
175
+ // timestamp: Permission expires at this time
176
+ expiresAt: timestamp2("expires_at", { withTimezone: true }),
177
+ ...timestamps4()
178
+ },
179
+ (table) => [
180
+ // Indexes for query performance
181
+ index4("user_permissions_user_id_idx").on(table.userId),
182
+ index4("user_permissions_permission_id_idx").on(table.permissionId),
183
+ index4("user_permissions_expires_at_idx").on(table.expiresAt),
184
+ // Unique constraint: one user-permission pair only
185
+ unique("user_permissions_unique").on(table.userId, table.permissionId)
186
+ ]
187
+ );
188
+ export {
189
+ userPermissions
190
+ };
191
+ //# sourceMappingURL=user-permissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/server/entities/user-permissions.ts","../../../src/server/entities/users.ts","../../../src/server/entities/roles.ts","../../../src/server/entities/permissions.ts"],"sourcesContent":["/**\n * @spfn/auth - User-Permissions Override Entity\n *\n * Per-user permission grants/revocations\n *\n * Features:\n * - Grant additional permissions to specific users\n * - Revoke role-inherited permissions from specific users\n * - Temporary permissions with expiration\n * - Audit trail with reason field\n *\n * Priority:\n * User permissions override role permissions\n */\n\nimport { bigint, boolean, text, timestamp, index, unique } from 'drizzle-orm/pg-core';\nimport { id, timestamps, createFunctionSchema } from '@spfn/core/db';\nimport { users } from './users';\nimport { permissions } from './permissions';\n\nconst schema = createFunctionSchema('@spfn/auth');\n\nexport const userPermissions = schema.table('user_permissions',\n {\n // Primary key\n id: id(),\n\n // Foreign key to users table\n userId: bigint('user_id', { mode: 'number' })\n .notNull()\n .references(() => users.id, { onDelete: 'cascade' }),\n\n // Foreign key to permissions table\n permissionId: bigint('permission_id', { mode: 'number' })\n .notNull()\n .references(() => permissions.id, { onDelete: 'cascade' }),\n\n // Grant or revoke\n // true: Grant this permission (even if role doesn't have it)\n // false: Revoke this permission (even if role has it)\n granted: boolean('granted').notNull().default(true),\n\n // Reason for grant/revocation (audit trail)\n reason: text('reason'),\n\n // Expiration timestamp (optional)\n // null: Permanent override\n // timestamp: Permission expires at this time\n expiresAt: timestamp('expires_at', { withTimezone: true }),\n\n ...timestamps(),\n },\n (table) => [\n // Indexes for query performance\n index('user_permissions_user_id_idx').on(table.userId),\n index('user_permissions_permission_id_idx').on(table.permissionId),\n index('user_permissions_expires_at_idx').on(table.expiresAt),\n\n // Unique constraint: one user-permission pair only\n unique('user_permissions_unique').on(table.userId, table.permissionId),\n ]\n);\n\n// Type exports\nexport type UserPermission = typeof userPermissions.$inferSelect;\nexport type NewUserPermission = typeof userPermissions.$inferInsert;","/**\n * @spfn/auth - Users Entity\n *\n * Main user table supporting multiple authentication methods\n *\n * Features:\n * - Email or phone-based registration\n * - Password authentication (bcrypt)\n * - OAuth support (nullable passwordHash)\n * - Role-based access control (RBAC)\n * - Account status management\n * - Email/phone verification\n */\n\nimport { text, timestamp, check, boolean, bigint, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, createFunctionSchema } from '@spfn/core/db';\nimport { sql } from 'drizzle-orm';\nimport { roles } from './roles';\n\nconst schema = createFunctionSchema('@spfn/auth');\n\nexport const users = schema.table('users',\n {\n // Identity\n id: id(),\n\n // Email address (unique identifier)\n // Used for: login, password reset, notifications\n email: text('email').unique(),\n\n // Phone number in E.164 international format\n // Format: +[country code][number] (e.g., +821012345678)\n // Used for: SMS login, 2FA, notifications\n phone: text('phone').unique(),\n\n // Authentication\n // Bcrypt password hash ($2b$10$[salt][hash], 60 chars)\n // Nullable to support OAuth-only accounts\n passwordHash: text('password_hash'),\n\n // Force password change on next login\n // Use cases: initial setup, security breach, policy violation\n passwordChangeRequired: boolean('password_change_required').notNull().default(false),\n\n // Authorization (Role-Based Access Control)\n // Foreign key to roles table\n // References built-in roles: user (default), admin, superadmin\n // Can also reference custom roles created at runtime\n roleId: bigint('role_id', { mode: 'number' })\n .references(() => roles.id)\n .notNull(),\n\n // Account status\n // - active: Normal operation (default)\n // - inactive: Deactivated (user request, dormant)\n // - suspended: Locked (security incident, ToS violation)\n status: text(\n 'status',\n {\n enum: ['active', 'inactive', 'suspended']\n }\n ).notNull().default('active'),\n\n // Verification timestamps\n // null = unverified, timestamp = verified at this time\n // Email verification (via verification code or magic link)\n emailVerifiedAt: timestamp('email_verified_at', { withTimezone: true }),\n\n // Phone verification (via SMS OTP)\n phoneVerifiedAt: timestamp('phone_verified_at', { withTimezone: true }),\n\n // Metadata\n // Last successful login timestamp\n // Used for: security auditing, dormant account detection\n lastLoginAt: timestamp('last_login_at', { withTimezone: true }),\n\n ...timestamps(),\n },\n (table) => [\n // Database constraints\n // Ensure at least one identifier exists (email OR phone)\n check(\n 'email_or_phone_check',\n sql`${table.email} IS NOT NULL OR ${table.phone} IS NOT NULL`\n ),\n\n // Indexes for query optimization\n index('users_email_idx').on(table.email),\n index('users_phone_idx').on(table.phone),\n index('users_status_idx').on(table.status),\n index('users_role_id_idx').on(table.roleId),\n ]\n);\n\n// Type exports\nexport type User = typeof users.$inferSelect;\nexport type NewUser = typeof users.$inferInsert;\nexport type UserStatus = 'active' | 'inactive' | 'suspended';\n\n// Helper type with computed verification status\nexport type UserWithVerification = User &\n{\n isEmailVerified: boolean;\n isPhoneVerified: boolean;\n};","/**\n * @spfn/auth - Roles Entity\n *\n * Role-based access control (RBAC) roles table\n *\n * Features:\n * - Built-in roles (user, admin, superadmin) - cannot be deleted\n * - System roles (preset roles) - can be deactivated\n * - Custom roles (runtime created) - fully manageable\n * - Priority-based hierarchy\n */\n\nimport { text, boolean, integer, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, createFunctionSchema } from '@spfn/core/db';\n\nconst schema = createFunctionSchema('@spfn/auth');\n\nexport const roles = schema.table('roles',\n {\n // Primary key\n id: id(),\n\n // Role identifier (used in code, e.g., 'admin', 'editor')\n // Must be unique, lowercase, kebab-case recommended\n name: text('name').notNull().unique(),\n\n // Display name for UI (e.g., 'Administrator', 'Content Editor')\n displayName: text('display_name').notNull(),\n\n // Role description\n description: text('description'),\n\n // Built-in role flag\n // true: Core package roles (user, admin, superadmin) - cannot be deleted\n // false: Custom or preset roles - can be deleted\n isBuiltin: boolean('is_builtin').notNull().default(false),\n\n // System role flag\n // true: Defined in code (builtin or preset) - deletion restricted\n // false: Runtime created custom role - fully manageable\n isSystem: boolean('is_system').notNull().default(false),\n\n // Active status\n // false: Deactivated role (users cannot be assigned)\n isActive: boolean('is_active').notNull().default(true),\n\n // Priority level (higher = more privileged)\n // superadmin: 100, admin: 80, user: 10\n // Used for role hierarchy and conflict resolution\n priority: integer('priority').notNull().default(10),\n\n ...timestamps(),\n },\n (table) => [\n index('roles_name_idx').on(table.name),\n index('roles_is_system_idx').on(table.isSystem),\n index('roles_is_active_idx').on(table.isActive),\n index('roles_is_builtin_idx').on(table.isBuiltin),\n index('roles_priority_idx').on(table.priority),\n ]\n);\n\n// Type exports\nexport type RoleEntity = typeof roles.$inferSelect;\nexport type NewRoleEntity = typeof roles.$inferInsert;\n\n// Legacy alias for backward compatibility\nexport type Role = RoleEntity;\nexport type NewRole = NewRoleEntity;","/**\n * @spfn/auth - Permissions Entity\n *\n * Granular permissions for RBAC system\n *\n * Features:\n * - Built-in permissions (auth:*, user:*, rbac:*) - required for package\n * - System permissions (preset permissions) - optional\n * - Custom permissions (app-specific) - defined by developers\n * - Category grouping for organization\n */\n\nimport { text, boolean, index } from 'drizzle-orm/pg-core';\nimport { id, timestamps, createFunctionSchema } from '@spfn/core/db';\n\nconst schema = createFunctionSchema('@spfn/auth');\n\nexport const permissions = schema.table('permissions',\n {\n // Primary key\n id: id(),\n\n // Permission identifier (e.g., 'user:delete', 'post:publish')\n // Format: resource:action or namespace:resource:action\n // Must be unique\n name: text('name').notNull().unique(),\n\n // Display name for UI\n displayName: text('display_name').notNull(),\n\n // Permission description\n description: text('description'),\n\n // Category for grouping (e.g., 'user', 'post', 'admin', 'system')\n category: text('category'),\n\n // Built-in permission flag\n // true: Core package permissions - cannot be deleted\n // false: Custom or preset permissions\n isBuiltin: boolean('is_builtin').notNull().default(false),\n\n // System permission flag\n // true: Defined in code (builtin or preset)\n // false: Runtime created custom permission\n isSystem: boolean('is_system').notNull().default(false),\n\n // Active status\n // false: Deactivated permission (not enforced)\n isActive: boolean('is_active').notNull().default(true),\n\n ...timestamps(),\n },\n (table) => [\n index('permissions_name_idx').on(table.name),\n index('permissions_category_idx').on(table.category),\n index('permissions_is_system_idx').on(table.isSystem),\n index('permissions_is_active_idx').on(table.isActive),\n index('permissions_is_builtin_idx').on(table.isBuiltin),\n ]\n);\n\n// Type exports\nexport type PermissionEntity = typeof permissions.$inferSelect;\nexport type NewPermissionEntity = typeof permissions.$inferInsert;\n\n// Legacy alias for backward compatibility\nexport type Permission = PermissionEntity;\nexport type NewPermission = NewPermissionEntity;"],"mappings":"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","names":["bigint","boolean","text","timestamp","index","id","timestamps","createFunctionSchema","text","boolean","index","id","timestamps","createFunctionSchema","schema","createFunctionSchema","id","text","boolean","timestamps","index","text","boolean","index","id","timestamps","createFunctionSchema","schema","schema","createFunctionSchema","id","bigint","boolean","text","timestamp","timestamps","index"]}
@@ -0,0 +1,227 @@
1
+ import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
2
+
3
+ /**
4
+ * @spfn/auth - User Public Keys Entity
5
+ *
6
+ * Stores client-generated public keys for JWT verification
7
+ * Supports key rotation and multi-key management per user
8
+ */
9
+ /**
10
+ * User Public Keys Table
11
+ * Each user can have multiple public keys (for rotation)
12
+ */
13
+ declare const userPublicKeys: drizzle_orm_pg_core.PgTableWithColumns<{
14
+ name: "user_public_keys";
15
+ schema: string;
16
+ columns: {
17
+ id: drizzle_orm_pg_core.PgColumn<{
18
+ name: "id";
19
+ tableName: "user_public_keys";
20
+ dataType: "number";
21
+ columnType: "PgBigSerial53";
22
+ data: number;
23
+ driverParam: number;
24
+ notNull: true;
25
+ hasDefault: true;
26
+ isPrimaryKey: true;
27
+ isAutoincrement: false;
28
+ hasRuntimeDefault: false;
29
+ enumValues: undefined;
30
+ baseColumn: never;
31
+ identity: undefined;
32
+ generated: undefined;
33
+ }, {}, {}>;
34
+ userId: drizzle_orm_pg_core.PgColumn<{
35
+ name: `${string}_id`;
36
+ tableName: "user_public_keys";
37
+ dataType: "number";
38
+ columnType: "PgBigSerial53";
39
+ data: number;
40
+ driverParam: number;
41
+ notNull: true;
42
+ hasDefault: true;
43
+ isPrimaryKey: false;
44
+ isAutoincrement: false;
45
+ hasRuntimeDefault: false;
46
+ enumValues: undefined;
47
+ baseColumn: never;
48
+ identity: undefined;
49
+ generated: undefined;
50
+ }, {}, {}>;
51
+ keyId: drizzle_orm_pg_core.PgColumn<{
52
+ name: "key_id";
53
+ tableName: "user_public_keys";
54
+ dataType: "string";
55
+ columnType: "PgText";
56
+ data: string;
57
+ driverParam: string;
58
+ notNull: true;
59
+ hasDefault: false;
60
+ isPrimaryKey: false;
61
+ isAutoincrement: false;
62
+ hasRuntimeDefault: false;
63
+ enumValues: [string, ...string[]];
64
+ baseColumn: never;
65
+ identity: undefined;
66
+ generated: undefined;
67
+ }, {}, {}>;
68
+ publicKey: drizzle_orm_pg_core.PgColumn<{
69
+ name: "public_key";
70
+ tableName: "user_public_keys";
71
+ dataType: "string";
72
+ columnType: "PgText";
73
+ data: string;
74
+ driverParam: string;
75
+ notNull: true;
76
+ hasDefault: false;
77
+ isPrimaryKey: false;
78
+ isAutoincrement: false;
79
+ hasRuntimeDefault: false;
80
+ enumValues: [string, ...string[]];
81
+ baseColumn: never;
82
+ identity: undefined;
83
+ generated: undefined;
84
+ }, {}, {}>;
85
+ algorithm: drizzle_orm_pg_core.PgColumn<{
86
+ name: "algorithm";
87
+ tableName: "user_public_keys";
88
+ dataType: "string";
89
+ columnType: "PgText";
90
+ data: "ES256" | "RS256";
91
+ driverParam: string;
92
+ notNull: true;
93
+ hasDefault: true;
94
+ isPrimaryKey: false;
95
+ isAutoincrement: false;
96
+ hasRuntimeDefault: false;
97
+ enumValues: ["ES256", "RS256"];
98
+ baseColumn: never;
99
+ identity: undefined;
100
+ generated: undefined;
101
+ }, {}, {}>;
102
+ fingerprint: drizzle_orm_pg_core.PgColumn<{
103
+ name: "fingerprint";
104
+ tableName: "user_public_keys";
105
+ dataType: "string";
106
+ columnType: "PgText";
107
+ data: string;
108
+ driverParam: string;
109
+ notNull: true;
110
+ hasDefault: false;
111
+ isPrimaryKey: false;
112
+ isAutoincrement: false;
113
+ hasRuntimeDefault: false;
114
+ enumValues: [string, ...string[]];
115
+ baseColumn: never;
116
+ identity: undefined;
117
+ generated: undefined;
118
+ }, {}, {}>;
119
+ isActive: drizzle_orm_pg_core.PgColumn<{
120
+ name: "is_active";
121
+ tableName: "user_public_keys";
122
+ dataType: "boolean";
123
+ columnType: "PgBoolean";
124
+ data: boolean;
125
+ driverParam: boolean;
126
+ notNull: true;
127
+ hasDefault: true;
128
+ isPrimaryKey: false;
129
+ isAutoincrement: false;
130
+ hasRuntimeDefault: false;
131
+ enumValues: undefined;
132
+ baseColumn: never;
133
+ identity: undefined;
134
+ generated: undefined;
135
+ }, {}, {}>;
136
+ createdAt: drizzle_orm_pg_core.PgColumn<{
137
+ name: "created_at";
138
+ tableName: "user_public_keys";
139
+ dataType: "date";
140
+ columnType: "PgTimestamp";
141
+ data: Date;
142
+ driverParam: string;
143
+ notNull: true;
144
+ hasDefault: true;
145
+ isPrimaryKey: false;
146
+ isAutoincrement: false;
147
+ hasRuntimeDefault: false;
148
+ enumValues: undefined;
149
+ baseColumn: never;
150
+ identity: undefined;
151
+ generated: undefined;
152
+ }, {}, {}>;
153
+ lastUsedAt: drizzle_orm_pg_core.PgColumn<{
154
+ name: "last_used_at";
155
+ tableName: "user_public_keys";
156
+ dataType: "date";
157
+ columnType: "PgTimestamp";
158
+ data: Date;
159
+ driverParam: string;
160
+ notNull: false;
161
+ hasDefault: false;
162
+ isPrimaryKey: false;
163
+ isAutoincrement: false;
164
+ hasRuntimeDefault: false;
165
+ enumValues: undefined;
166
+ baseColumn: never;
167
+ identity: undefined;
168
+ generated: undefined;
169
+ }, {}, {}>;
170
+ expiresAt: drizzle_orm_pg_core.PgColumn<{
171
+ name: "expires_at";
172
+ tableName: "user_public_keys";
173
+ dataType: "date";
174
+ columnType: "PgTimestamp";
175
+ data: Date;
176
+ driverParam: string;
177
+ notNull: false;
178
+ hasDefault: false;
179
+ isPrimaryKey: false;
180
+ isAutoincrement: false;
181
+ hasRuntimeDefault: false;
182
+ enumValues: undefined;
183
+ baseColumn: never;
184
+ identity: undefined;
185
+ generated: undefined;
186
+ }, {}, {}>;
187
+ revokedAt: drizzle_orm_pg_core.PgColumn<{
188
+ name: "revoked_at";
189
+ tableName: "user_public_keys";
190
+ dataType: "date";
191
+ columnType: "PgTimestamp";
192
+ data: Date;
193
+ driverParam: string;
194
+ notNull: false;
195
+ hasDefault: false;
196
+ isPrimaryKey: false;
197
+ isAutoincrement: false;
198
+ hasRuntimeDefault: false;
199
+ enumValues: undefined;
200
+ baseColumn: never;
201
+ identity: undefined;
202
+ generated: undefined;
203
+ }, {}, {}>;
204
+ revokedReason: drizzle_orm_pg_core.PgColumn<{
205
+ name: "revoked_reason";
206
+ tableName: "user_public_keys";
207
+ dataType: "string";
208
+ columnType: "PgText";
209
+ data: string;
210
+ driverParam: string;
211
+ notNull: false;
212
+ hasDefault: false;
213
+ isPrimaryKey: false;
214
+ isAutoincrement: false;
215
+ hasRuntimeDefault: false;
216
+ enumValues: [string, ...string[]];
217
+ baseColumn: never;
218
+ identity: undefined;
219
+ generated: undefined;
220
+ }, {}, {}>;
221
+ };
222
+ dialect: "pg";
223
+ }>;
224
+ type UserPublicKey = typeof userPublicKeys.$inferSelect;
225
+ type NewUserPublicKey = typeof userPublicKeys.$inferInsert;
226
+
227
+ export { type NewUserPublicKey, type UserPublicKey, userPublicKeys };