zitejs 0.3.0 → 0.4.0

package/api/index.d.ts

@@ -1,47 +1,21 @@
 /**
- * zitejs/api — Server-side endpoint definition + typed client caller.
+ * zitejs/api — Client-side typed API caller.
  *
- * Server-side (defining endpoints):
- *   import { createEndpoint, ZiteError } from 'zitejs/api';
- *   export default createEndpoint({ ... });
+ * Used in generated .zite/api.ts files:
+ *   import { createCaller } from 'zitejs/api';
+ *   import myEndpoint from '../src/api/myEndpoint';
+ *   export const api = { myEndpoint: createCaller(myEndpoint) };
  *
- * Client-side (generated by zitejs sync into .zite/api.ts):
- *   import { api } from './.zite/api';
- *   await api.getRecords({ table: 'contacts' });
+ * Then consumed in app code:
+ *   import { api } from 'zitejs/api'; // resolved via tsconfig to .zite/api.ts
+ *   await api.myEndpoint({ ... });
  */
 
-export interface ZiteRequestContext {
-  userId?: string;
-  organizationId?: string;
-  [key: string]: unknown;
-}
-
-export interface ZiteScheduledContext extends ZiteRequestContext {
-  scheduledAt: string;
-}
-
-export declare class ZiteError extends Error {
-  constructor(message: string, options?: { statusCode?: number });
-  statusCode: number;
-}
-
 export interface EndpointConfig<TInput = unknown, TOutput = unknown> {
-  description?: string;
-  inputSchema?: unknown;
-  outputSchema?: unknown;
-  stream?: boolean;
   _name?: string;
-  execute: (params: {
-    input: TInput;
-    context: ZiteRequestContext | ZiteScheduledContext;
-  }) => Promise<TOutput> | TOutput;
+  execute: (params: { input: TInput; context: unknown }) => Promise<TOutput> | TOutput;
 }
 
-export declare function createEndpoint<
-  TInput = unknown,
-  TOutput = unknown,
->(config: EndpointConfig<TInput, TOutput>): EndpointConfig<TInput, TOutput>;
-
 export declare function createCaller<TInput, TOutput>(
   endpoint: EndpointConfig<TInput, TOutput>,
 ): (input: TInput) => Promise<TOutput>;

package/api/index.js

@@ -1,20 +1,8 @@
-// zitejs/api — server-side endpoint definition + client caller factory.
+// zitejs/api — client-side typed API caller factory.
 
 const BASE_URL = process.env.ZITE_API_URL ?? '';
 const TOKEN = process.env.ZITE_DB_TOKEN ?? '';
 
-export class ZiteError extends Error {
-  constructor(message, options) {
-    super(message);
-    this.name = 'ZiteError';
-    this.statusCode = options?.statusCode ?? 500;
-  }
-}
-
-export function createEndpoint(config) {
-  return config;
-}
-
 export function createCaller(endpoint) {
   return async (input) => {
     const res = await fetch(BASE_URL + '/api/' + endpoint._name, {
@@ -27,7 +15,7 @@ export function createCaller(endpoint) {
     });
     if (!res.ok) {
       const text = await res.text().catch(() => '');
-      throw new ZiteError(`API call failed (${res.status}): ${text}`);
+      throw new Error(`API call failed (${res.status}): ${text}`);
     }
     return res.json();
   };

package/backend/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * zitejs/backend — Server-side endpoint definition.
+ *
+ * Usage:
+ *   import { createEndpoint, ZiteError } from 'zitejs/backend';
+ *   export default createEndpoint({ ... });
+ */
+
+export interface ZiteRequestContext {
+  userId?: string;
+  organizationId?: string;
+  [key: string]: unknown;
+}
+
+export interface ZiteScheduledContext extends ZiteRequestContext {
+  scheduledAt: string;
+}
+
+export declare class ZiteError extends Error {
+  constructor(message: string, options?: { statusCode?: number });
+  statusCode: number;
+}
+
+export interface EndpointConfig<TInput = unknown, TOutput = unknown> {
+  description?: string;
+  inputSchema?: unknown;
+  outputSchema?: unknown;
+  stream?: boolean;
+  _name?: string;
+  execute: (params: {
+    input: TInput;
+    context: ZiteRequestContext | ZiteScheduledContext;
+  }) => Promise<TOutput> | TOutput;
+}
+
+export declare function createEndpoint<
+  TInput = unknown,
+  TOutput = unknown,
+>(config: EndpointConfig<TInput, TOutput>): EndpointConfig<TInput, TOutput>;

package/backend/index.js

@@ -0,0 +1,13 @@
+// zitejs/backend — server-side endpoint definition.
+
+export class ZiteError extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = 'ZiteError';
+    this.statusCode = options?.statusCode ?? 500;
+  }
+}
+
+export function createEndpoint(config) {
+  return config;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "bin": {
@@ -15,6 +15,10 @@
       "types": "./api/index.d.ts",
       "default": "./api/index.js"
     },
+    "./backend": {
+      "types": "./backend/index.d.ts",
+      "default": "./backend/index.js"
+    },
     "./auth": {
       "types": "./auth/index.d.ts",
       "default": "./auth/index.js"
@@ -38,6 +42,7 @@
   "files": [
     "db",
     "api",
+    "backend",
     "auth",
     "upload",
     "pdf",