@cfast/admin 0.2.0 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Schmidt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -297,8 +297,8 @@ type AdminConfig = {
     db: CreateDbFn;
     /** Auth adapter that provides user authentication, role management, and impersonation. See {@link AdminAuthConfig}. */
     auth: AdminAuthConfig;
-    /** Your Drizzle schema object (e.g., `import * as schema from "~/schema"`). Tables are introspected from this. */
-    schema: Record<string, SQLiteTable>;
+    /** Your Drizzle schema object (e.g., `import * as schema from "~/schema"`). Non-table exports (Relations, helpers) are silently skipped. */
+    schema: Record<string, unknown>;
     /** Per-table display and behavior overrides, keyed by table name. See {@link TableOverrides}. */
     tables?: Record<string, TableOverrides>;
     /** Configuration for the built-in user management views. See {@link UserManagementConfig}. */
@@ -640,7 +640,7 @@ declare function createAdmin(config: AdminConfig): {
  * });
  * ```
  */
-declare function introspectSchema(schema: Record<string, SQLiteTable>, tableOverrides?: Record<string, TableOverrides>): AdminTableMeta[];
+declare function introspectSchema(schema: Record<string, unknown>, tableOverrides?: Record<string, TableOverrides>): AdminTableMeta[];
 
 /**
  * Create an admin loader function from config and introspected table metadata.

package/dist/index.js

@@ -1,6 +1,7 @@
 // src/introspect.ts
 import { getTableConfig } from "drizzle-orm/sqlite-core";
 import { getTableColumns, getTableName } from "drizzle-orm";
+import { isTable } from "drizzle-orm";
 var AUTO_EXCLUDED_TABLES = /* @__PURE__ */ new Set([
   "session",
   "account",
@@ -42,7 +43,11 @@ function columnNameToLabel(name) {
 }
 function introspectSchema(schema, tableOverrides) {
   const result = [];
-  for (const [_key, table] of Object.entries(schema)) {
+  for (const [_key, value] of Object.entries(schema)) {
+    if (!isTable(value)) {
+      continue;
+    }
+    const table = value;
     const tableName = getTableName(table);
     const overrides = tableOverrides?.[tableName] ?? {};
     if (overrides.exclude === true) {
@@ -127,7 +132,7 @@ function defaultSearchableColumns(columns) {
 }
 
 // src/loader.ts
-import { getTableColumns as getTableColumns2, getTableName as getTableName2, eq, like, or, asc, desc } from "drizzle-orm";
+import { getTableColumns as getTableColumns2, getTableName as getTableName2, eq, like, or, asc, desc, isTable as isTable2 } from "drizzle-orm";
 
 // src/utils.ts
 var USERS_VIEW = "_users";
@@ -265,10 +270,11 @@ function getColumn(drizzleTable, columnName) {
   return columns[columnName];
 }
 function findUsersTable(schema) {
-  for (const table of Object.values(schema)) {
-    const name = getTableName2(table);
+  for (const value of Object.values(schema)) {
+    if (!isTable2(value)) continue;
+    const name = getTableName2(value);
     if (name === "user" || name === "users") {
-      return table;
+      return value;
     }
   }
   return void 0;

package/llms.txt

@@ -165,3 +165,8 @@ const admin = createAdmin({
 - Not providing `impersonate`/`stopImpersonation` callbacks and expecting impersonation to work -- these are optional but required for that feature.
 - Trying to customize rendering by passing JSX to `createAdmin` -- instead, override fields via `TableOverrides.fields` (for forms) or use `@cfast/ui` components directly in custom routes.
 - Expecting auth-internal tables (`session`, `account`, `verification`, `passkey`) to show up -- they are auto-excluded. Set `exclude: false` in table overrides to show them.
+
+## See Also
+
+- `@cfast/forms` -- Schema-derived forms used for create/edit views.
+- `@cfast/ui` + `@cfast/joy` -- Headless components and Joy UI styling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfast/admin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Auto-generated admin UI from your Drizzle schema with role management and impersonation",
   "keywords": [
     "cfast",
@@ -32,13 +32,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts",
-    "dev": "tsup src/index.ts --format esm --dts --watch",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
-    "test": "vitest run"
-  },
   "peerDependencies": {
     "@mui/joy": ">=5.0.0-beta.0",
     "react": ">=19",
@@ -52,11 +45,11 @@
     }
   },
   "dependencies": {
-    "@cfast/db": "workspace:*",
-    "@cfast/forms": "workspace:*",
-    "@cfast/permissions": "workspace:*",
-    "@cfast/joy": "workspace:*",
-    "@cfast/ui": "workspace:*"
+    "@cfast/db": "0.1.1",
+    "@cfast/forms": "0.1.0",
+    "@cfast/permissions": "0.1.0",
+    "@cfast/ui": "0.2.1",
+    "@cfast/joy": "0.1.0"
   },
   "devDependencies": {
     "@emotion/react": "^11.14.0",
@@ -71,5 +64,12 @@
     "tsup": "^8",
     "typescript": "^5.7",
     "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run"
   }
-}
+}