zitejs 0.9.88 → 0.9.90

package/README.md

@@ -7,7 +7,21 @@ The Zite framework package. Provides typed access to your Zite Database, API end
 ```ts
 // Database client (generated per-project by `zite sync`)
 import { zite } from 'zitejs/db';
-const users = await zite.users.findMany();
+const contacts = await zite.contacts.findAll();
+
+// Query and update Zite auth users from backend endpoints
+const { records: users } = await zite.auth.findAllUsers({
+  appIds: ['app-1'],
+  filters: { email: 'person@example.com' },
+});
+await zite.auth.updateUserProfile(users[0].id, {
+  firstName: 'New name',
+});
+
+// Auth users can also be queried with read-only SQL
+const result = await zite.sql({
+  query: 'SELECT "id", "email" FROM "ziteUsers"',
+});
 
 // Define API endpoints
 import { createEndpoint, ZiteError } from 'zitejs/api';

package/dist/cjs/runtime/index.d.ts

@@ -1,5 +1,12 @@
 import type { NotificationsCreateParams, NotificationsCreateResult } from "../notifications/index.js";
-import type { MetaListUsersResult } from "../meta/index.js";
+export interface TableFindAllOptions {
+    limit?: number;
+    offset?: number;
+    sort?: unknown[];
+    filter?: unknown;
+    filters?: unknown;
+    fields?: string[];
+}
 export interface BulkCreateResult<T> {
     success: boolean;
     records: T[];
@@ -12,14 +19,7 @@ export interface DeleteResult {
     id: string;
 }
 export interface TableClient<T> {
-    findAll(params?: {
-        limit?: number;
-        offset?: number;
-        sort?: unknown[];
-        filter?: unknown;
-        filters?: unknown;
-        fields?: string[];
-    }): Promise<{
+    findAll(params?: TableFindAllOptions): Promise<{
         records: T[];
         hasMore: boolean;
     }>;
@@ -57,6 +57,29 @@ export declare function createSqlClient(): (params: {
     query: string;
     params?: unknown[];
 }) => Promise<SqlResult>;
+export interface AuthUser {
+    id: string;
+    name: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    image: string | null;
+}
+export type FindAllAuthUsersOptions = Omit<TableFindAllOptions, "fields"> & {
+    /** Restrict results to users belonging to any of these apps. */
+    appIds?: string[];
+};
+export type FindAllAuthUsersResult<T extends AuthUser = AuthUser> = {
+    records: T[];
+    total: number;
+    hasMore: boolean;
+};
+export type UpdateAuthUserProfile = Partial<Omit<AuthUser, "id" | "email" | "name">>;
+export interface AuthClient<T extends AuthUser = AuthUser> {
+    findAllUsers(options?: FindAllAuthUsersOptions): Promise<FindAllAuthUsersResult<T>>;
+    updateUserProfile(userId: string, profile: UpdateAuthUserProfile): Promise<T>;
+}
+export declare function createAuthClient<T extends AuthUser = AuthUser>(): AuthClient<T>;
 export interface AirtableTableClient<T> {
     findAll(params?: {
         offset?: string;
@@ -154,10 +177,6 @@ export declare function createEmailClient(integrationId: string): EmailClient;
 export declare function createNotificationsClient(): {
     create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
 };
-export declare function createMetaClient(): {
-    listUsers(): Promise<MetaListUsersResult>;
-};
 export type { NotificationLink, NotificationsCreateParams, NotificationsCreateResult, } from "../notifications/index.js";
-export type { MetaListUsersResult, ZiteProjectUser } from "../meta/index.js";
 export { createCaller } from "../caller/index.js";
 export type { EndpointConfig } from "../caller/index.js";

package/dist/cjs/runtime/index.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCaller = void 0;
 exports.createTableClient = createTableClient;
 exports.createSqlClient = createSqlClient;
+exports.createAuthClient = createAuthClient;
 exports.createAirtableClient = createAirtableClient;
 exports.createEmailClient = createEmailClient;
 exports.createNotificationsClient = createNotificationsClient;
-exports.createMetaClient = createMetaClient;
 const sdkCall_js_1 = require("../internal/sdkCall.js");
 const DB_INTEGRATION_ID = "databases";
 function getBaseId() {
@@ -73,6 +73,19 @@ function createSqlClient() {
         ...params,
     });
 }
+function createAuthClient() {
+    return {
+        findAllUsers: (options) => (0, sdkCall_js_1.getSdkCall)()(DB_INTEGRATION_ID, "Auth", "findAllUsers", {
+            baseId: getBaseId(),
+            ...options,
+        }),
+        updateUserProfile: (userId, profile) => (0, sdkCall_js_1.getSdkCall)()(DB_INTEGRATION_ID, "Auth", "updateUserProfile", {
+            baseId: getBaseId(),
+            userId,
+            profile,
+        }),
+    };
+}
 function createAirtableClient(integrationId, className, implicitParams) {
     return {
         findAll: (params) => (0, sdkCall_js_1.getSdkCall)()(integrationId, className, "findAll", {
@@ -114,16 +127,10 @@ function createEmailClient(integrationId) {
     };
 }
 const NOTIFICATIONS_SDK_INTEGRATION_ID = "__notifications__";
-const META_SDK_INTEGRATION_ID = "__meta__";
 function createNotificationsClient() {
     return {
         create: (params) => (0, sdkCall_js_1.getSdkCall)()(NOTIFICATIONS_SDK_INTEGRATION_ID, "ZiteNotifications", "create", params),
     };
 }
-function createMetaClient() {
-    return {
-        listUsers: () => (0, sdkCall_js_1.getSdkCall)()(META_SDK_INTEGRATION_ID, "ZiteMeta", "listUsers", {}),
-    };
-}
 var index_js_1 = require("../caller/index.js");
 Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/sync/lib.js

@@ -9,6 +9,7 @@ exports.generateAirtableTs = generateAirtableTs;
 exports.generateBackendWrapperTs = generateBackendWrapperTs;
 exports.generateEmailSdk = generateEmailSdk;
 const parser_1 = require("@babel/parser");
+const AUTH_USERS_TABLE_ID = "zite_user";
 const FIELD_TYPE_MAP = {
     single_line_text: "string",
     long_text: "string",
@@ -197,6 +198,8 @@ function generateSchema(database, existingSchema) {
     }
     const tables = [];
     for (const table of database.tables) {
+        if (table.id === AUTH_USERS_TABLE_ID)
+            continue;
         const existingTable = existingTableById.get(table.id);
         const existingFieldById = new Map();
         for (const f of existingTable?.fields ?? []) {
@@ -243,16 +246,13 @@ function generateSentinelSdkTypes() {
         "  | { created: number }",
         "  | { created: 0; preview: true; wouldCreate: number };",
         "",
-        "export interface ZiteProjectUser {",
-        "  uuid: string;",
+        "export interface ZiteAuthUser {",
+        "  id: string;",
+        "  name: string;",
+        "  email: string;",
         "  firstName: string | null;",
         "  lastName: string | null;",
-        "  email: string;",
-        "  profilePictureUrl: string | null;",
-        "}",
-        "",
-        "export interface MetaListUsersResult {",
-        "  users: ZiteProjectUser[];",
+        "  image: string | null;",
         "}",
         "",
     ];
@@ -310,6 +310,7 @@ function buildLinkTableComments(schema) {
  */
 function generateDbTs(schema) {
     const lines = [];
+    const tables = schema.tables.filter((table) => table.id !== AUTH_USERS_TABLE_ID);
     lines.push("// Auto-generated by zitejs generate. Do not edit manually.");
     lines.push("//");
     lines.push("// Usage in endpoint files (src/api/*.ts):");
@@ -328,6 +329,13 @@ function generateDbTs(schema) {
     lines.push("//   .delete({ id }) → { id: string }");
     lines.push("//   .bulkCreate({ records, matchOn? }) → { success: boolean, records: T[] }");
     lines.push("//");
+    lines.push("// Zite auth users:");
+    lines.push("//   zite.auth.findAllUsers({ appIds?, filter?, filters?, sort?, limit?, offset? })");
+    lines.push("//     Supports the same filter, sort, and pagination options as table .findAll()");
+    lines.push("//     appIds restricts results to users belonging to any listed app");
+    lines.push("//   zite.auth.updateUserProfile(userId, { firstName?, lastName?, image? })");
+    lines.push("//   User email addresses cannot be updated through this API");
+    lines.push("//");
     lines.push("// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):");
     lines.push('//   zite.sql({ query: "SELECT ...", params?: [...] })');
     lines.push("//     → { rows: Record<string, unknown>[], columns, rowCount, truncated }");
@@ -336,13 +344,14 @@ function generateDbTs(schema) {
     lines.push("//   - Use SDK names for tables (PascalCase) and fields (camelCase)");
     lines.push('//   - ALWAYS double-quote every identifier: FROM "Orders", WHERE "status" = $1');
     lines.push("//   - Use params array for user input ($1, $2, ...): never interpolate into SQL");
+    lines.push('//   - Auth users are available as "ziteUsers" with id, name, email, firstName, lastName, and image');
     lines.push("//   - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL");
     lines.push("//   - SELECT only — use .create/.update/.delete for writes");
     lines.push('//   - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
     lines.push(...buildLinkTableComments(schema));
-    lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createMetaClient } from 'zitejs/runtime';");
+    lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createAuthClient } from 'zitejs/runtime';");
     lines.push("");
-    for (const table of schema.tables) {
+    for (const table of tables) {
         const className = toPascalCase(table.sdkName);
         const recordType = `${className}RecordType`;
         lines.push(`export type ${recordType} = {`);
@@ -362,13 +371,13 @@ function generateDbTs(schema) {
     }
     lines.push(...generateSentinelSdkTypes());
     lines.push("export const zite = {");
-    for (const table of schema.tables) {
+    for (const table of tables) {
         const className = toPascalCase(table.sdkName);
         lines.push(`  ${table.sdkName}: createTableClient<${className}RecordType>('${className}'),`);
     }
     lines.push(`  sql: createSqlClient(),`);
     lines.push(`  notifications: createNotificationsClient(),`);
-    lines.push(`  meta: createMetaClient(),`);
+    lines.push(`  auth: createAuthClient<ZiteAuthUser>(),`);
     lines.push("};");
     lines.push("");
     return lines.join("\n");

package/dist/esm/runtime/index.d.ts

@@ -1,5 +1,12 @@
 import type { NotificationsCreateParams, NotificationsCreateResult } from "../notifications/index.js";
-import type { MetaListUsersResult } from "../meta/index.js";
+export interface TableFindAllOptions {
+    limit?: number;
+    offset?: number;
+    sort?: unknown[];
+    filter?: unknown;
+    filters?: unknown;
+    fields?: string[];
+}
 export interface BulkCreateResult<T> {
     success: boolean;
     records: T[];
@@ -12,14 +19,7 @@ export interface DeleteResult {
     id: string;
 }
 export interface TableClient<T> {
-    findAll(params?: {
-        limit?: number;
-        offset?: number;
-        sort?: unknown[];
-        filter?: unknown;
-        filters?: unknown;
-        fields?: string[];
-    }): Promise<{
+    findAll(params?: TableFindAllOptions): Promise<{
         records: T[];
         hasMore: boolean;
     }>;
@@ -57,6 +57,29 @@ export declare function createSqlClient(): (params: {
     query: string;
     params?: unknown[];
 }) => Promise<SqlResult>;
+export interface AuthUser {
+    id: string;
+    name: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    image: string | null;
+}
+export type FindAllAuthUsersOptions = Omit<TableFindAllOptions, "fields"> & {
+    /** Restrict results to users belonging to any of these apps. */
+    appIds?: string[];
+};
+export type FindAllAuthUsersResult<T extends AuthUser = AuthUser> = {
+    records: T[];
+    total: number;
+    hasMore: boolean;
+};
+export type UpdateAuthUserProfile = Partial<Omit<AuthUser, "id" | "email" | "name">>;
+export interface AuthClient<T extends AuthUser = AuthUser> {
+    findAllUsers(options?: FindAllAuthUsersOptions): Promise<FindAllAuthUsersResult<T>>;
+    updateUserProfile(userId: string, profile: UpdateAuthUserProfile): Promise<T>;
+}
+export declare function createAuthClient<T extends AuthUser = AuthUser>(): AuthClient<T>;
 export interface AirtableTableClient<T> {
     findAll(params?: {
         offset?: string;
@@ -154,10 +177,6 @@ export declare function createEmailClient(integrationId: string): EmailClient;
 export declare function createNotificationsClient(): {
     create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
 };
-export declare function createMetaClient(): {
-    listUsers(): Promise<MetaListUsersResult>;
-};
 export type { NotificationLink, NotificationsCreateParams, NotificationsCreateResult, } from "../notifications/index.js";
-export type { MetaListUsersResult, ZiteProjectUser } from "../meta/index.js";
 export { createCaller } from "../caller/index.js";
 export type { EndpointConfig } from "../caller/index.js";

package/dist/esm/runtime/index.js

@@ -64,6 +64,19 @@ export function createSqlClient() {
         ...params,
     });
 }
+export function createAuthClient() {
+    return {
+        findAllUsers: (options) => getSdkCall()(DB_INTEGRATION_ID, "Auth", "findAllUsers", {
+            baseId: getBaseId(),
+            ...options,
+        }),
+        updateUserProfile: (userId, profile) => getSdkCall()(DB_INTEGRATION_ID, "Auth", "updateUserProfile", {
+            baseId: getBaseId(),
+            userId,
+            profile,
+        }),
+    };
+}
 export function createAirtableClient(integrationId, className, implicitParams) {
     return {
         findAll: (params) => getSdkCall()(integrationId, className, "findAll", {
@@ -105,15 +118,9 @@ export function createEmailClient(integrationId) {
     };
 }
 const NOTIFICATIONS_SDK_INTEGRATION_ID = "__notifications__";
-const META_SDK_INTEGRATION_ID = "__meta__";
 export function createNotificationsClient() {
     return {
         create: (params) => getSdkCall()(NOTIFICATIONS_SDK_INTEGRATION_ID, "ZiteNotifications", "create", params),
     };
 }
-export function createMetaClient() {
-    return {
-        listUsers: () => getSdkCall()(META_SDK_INTEGRATION_ID, "ZiteMeta", "listUsers", {}),
-    };
-}
 export { createCaller } from "../caller/index.js";

package/dist/esm/sync/lib.js

@@ -1,4 +1,5 @@
 import { parse } from "@babel/parser";
+const AUTH_USERS_TABLE_ID = "zite_user";
 const FIELD_TYPE_MAP = {
     single_line_text: "string",
     long_text: "string",
@@ -187,6 +188,8 @@ export function generateSchema(database, existingSchema) {
     }
     const tables = [];
     for (const table of database.tables) {
+        if (table.id === AUTH_USERS_TABLE_ID)
+            continue;
         const existingTable = existingTableById.get(table.id);
         const existingFieldById = new Map();
         for (const f of existingTable?.fields ?? []) {
@@ -233,16 +236,13 @@ function generateSentinelSdkTypes() {
         "  | { created: number }",
         "  | { created: 0; preview: true; wouldCreate: number };",
         "",
-        "export interface ZiteProjectUser {",
-        "  uuid: string;",
+        "export interface ZiteAuthUser {",
+        "  id: string;",
+        "  name: string;",
+        "  email: string;",
         "  firstName: string | null;",
         "  lastName: string | null;",
-        "  email: string;",
-        "  profilePictureUrl: string | null;",
-        "}",
-        "",
-        "export interface MetaListUsersResult {",
-        "  users: ZiteProjectUser[];",
+        "  image: string | null;",
         "}",
         "",
     ];
@@ -300,6 +300,7 @@ function buildLinkTableComments(schema) {
  */
 export function generateDbTs(schema) {
     const lines = [];
+    const tables = schema.tables.filter((table) => table.id !== AUTH_USERS_TABLE_ID);
     lines.push("// Auto-generated by zitejs generate. Do not edit manually.");
     lines.push("//");
     lines.push("// Usage in endpoint files (src/api/*.ts):");
@@ -318,6 +319,13 @@ export function generateDbTs(schema) {
     lines.push("//   .delete({ id }) → { id: string }");
     lines.push("//   .bulkCreate({ records, matchOn? }) → { success: boolean, records: T[] }");
     lines.push("//");
+    lines.push("// Zite auth users:");
+    lines.push("//   zite.auth.findAllUsers({ appIds?, filter?, filters?, sort?, limit?, offset? })");
+    lines.push("//     Supports the same filter, sort, and pagination options as table .findAll()");
+    lines.push("//     appIds restricts results to users belonging to any listed app");
+    lines.push("//   zite.auth.updateUserProfile(userId, { firstName?, lastName?, image? })");
+    lines.push("//   User email addresses cannot be updated through this API");
+    lines.push("//");
     lines.push("// Raw SQL (read-only SELECTs for aggregates, joins, multi-table queries):");
     lines.push('//   zite.sql({ query: "SELECT ...", params?: [...] })');
     lines.push("//     → { rows: Record<string, unknown>[], columns, rowCount, truncated }");
@@ -326,13 +334,14 @@ export function generateDbTs(schema) {
     lines.push("//   - Use SDK names for tables (PascalCase) and fields (camelCase)");
     lines.push('//   - ALWAYS double-quote every identifier: FROM "Orders", WHERE "status" = $1');
     lines.push("//   - Use params array for user input ($1, $2, ...): never interpolate into SQL");
+    lines.push('//   - Auth users are available as "ziteUsers" with id, name, email, firstName, lastName, and image');
     lines.push("//   - Soft-deleted rows are excluded automatically — no WHERE deleted_at IS NULL");
     lines.push("//   - SELECT only — use .create/.update/.delete for writes");
     lines.push('//   - Load the "zite:sql" skill for full SQL reference (formulas, lookups, etc.)');
     lines.push(...buildLinkTableComments(schema));
-    lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createMetaClient } from 'zitejs/runtime';");
+    lines.push("import { createTableClient, createSqlClient, createNotificationsClient, createAuthClient } from 'zitejs/runtime';");
     lines.push("");
-    for (const table of schema.tables) {
+    for (const table of tables) {
         const className = toPascalCase(table.sdkName);
         const recordType = `${className}RecordType`;
         lines.push(`export type ${recordType} = {`);
@@ -352,13 +361,13 @@ export function generateDbTs(schema) {
     }
     lines.push(...generateSentinelSdkTypes());
     lines.push("export const zite = {");
-    for (const table of schema.tables) {
+    for (const table of tables) {
         const className = toPascalCase(table.sdkName);
         lines.push(`  ${table.sdkName}: createTableClient<${className}RecordType>('${className}'),`);
     }
     lines.push(`  sql: createSqlClient(),`);
     lines.push(`  notifications: createNotificationsClient(),`);
-    lines.push(`  meta: createMetaClient(),`);
+    lines.push(`  auth: createAuthClient<ZiteAuthUser>(),`);
     lines.push("};");
     lines.push("");
     return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.88",
+  "version": "0.9.90",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -73,11 +73,6 @@
       "import": "./dist/esm/notifications/index.js",
       "require": "./dist/cjs/notifications/index.js"
     },
-    "./meta": {
-      "types": "./dist/esm/meta/index.d.ts",
-      "import": "./dist/esm/meta/index.js",
-      "require": "./dist/cjs/meta/index.js"
-    },
     "./sync": {
       "types": "./dist/esm/sync/index.d.ts",
       "import": "./dist/esm/sync/index.js",
@@ -138,9 +133,6 @@
       "notifications": [
         "dist/esm/notifications/index.d.ts"
       ],
-      "meta": [
-        "dist/esm/meta/index.d.ts"
-      ],
       "vite-plugin": [
         "dist/esm/vite/index.d.ts"
       ]

package/dist/cjs/api/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCaller = void 0;
-var index_js_1 = require("../caller/index.js");
-Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/db/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTableClient = void 0;
-var index_js_1 = require("../runtime/index.js");
-Object.defineProperty(exports, "createTableClient", { enumerable: true, get: function () { return index_js_1.createTableClient; } });

package/dist/esm/api/index.d.ts

@@ -1,2 +0,0 @@
-export { createCaller } from '../caller/index.js';
-export type { EndpointConfig } from '../caller/index.js';

package/dist/esm/api/index.js

@@ -1 +0,0 @@
-export { createCaller } from '../caller/index.js';

package/dist/esm/db/index.d.ts

@@ -1,2 +0,0 @@
-export { createTableClient } from '../runtime/index.js';
-export type { TableClient } from '../runtime/index.js';

package/dist/esm/db/index.js

@@ -1 +0,0 @@
-export { createTableClient } from '../runtime/index.js';