zitejs 0.0.1 → 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# zitejs
+
+The Zite framework package. Provides typed access to your Zite Database, API endpoints, authentication, and more.
+
+## Usage
+
+```ts
+// Database client (generated per-project by `zite sync`)
+import { zite } from 'zitejs/db';
+const users = await zite.users.findMany();
+
+// Define API endpoints
+import { createEndpoint, ZiteError } from 'zitejs/api';
+export default createEndpoint({
+  execute: async ({ input }) => { ... },
+});
+
+// Authentication
+import { useAuth } from 'zitejs/auth';
+const { user } = useAuth();
+
+// File uploads
+import { useUpload } from 'zitejs/upload';
+
+// PDF generation
+import { ZitePdf } from 'zitejs/pdf';
+
+// Scheduled tasks
+import { ZiteSchedule } from 'zitejs/schedules';
+```

package/api/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * zitejs/api — Server-side endpoint definition.
+ *
+ * Usage:
+ *   import { createEndpoint, ZiteError } from 'zitejs/api';
+ *
+ *   export default createEndpoint({
+ *     description: 'Get user by ID',
+ *     inputSchema: z.object({ id: z.string() }),
+ *     outputSchema: z.object({ name: z.string() }),
+ *     execute: async ({ input }) => {
+ *       const user = await zite.users.findOne(input.id);
+ *       return { name: user.name };
+ *     },
+ *   });
+ */
+
+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 declare function createEndpoint<TInput = unknown, TOutput = unknown>(config: {
+  description?: string;
+  inputSchema?: unknown;
+  outputSchema?: unknown;
+  stream?: boolean;
+  execute: (params: {
+    input: TInput;
+    context: ZiteRequestContext | ZiteScheduledContext;
+  }) => Promise<TOutput> | TOutput;
+}): unknown;

package/api/index.js

@@ -0,0 +1,13 @@
+// zitejs/api — runtime stub.
+// The actual implementations are injected by the Zite sandbox at runtime.
+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/auth/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * zitejs/auth — Authentication helpers.
+ *
+ * Usage:
+ *   import { useAuth } from 'zitejs/auth';
+ *   const { user, isLoading } = useAuth();
+ */
+
+export interface ZiteUser {
+  id: string;
+  email?: string;
+  name?: string;
+  [key: string]: unknown;
+}
+
+export declare function useAuth(): {
+  user: ZiteUser | null;
+  isLoading: boolean;
+  authLoading: boolean;
+  logout: () => void;
+};
+
+export declare function getCurrentUser(): ZiteUser | null;

package/auth/index.js

@@ -0,0 +1,8 @@
+// zitejs/auth — runtime stub.
+export function useAuth() {
+  return { user: null, isLoading: true, authLoading: true, logout: () => {} };
+}
+
+export function getCurrentUser() {
+  return null;
+}

package/db/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * zitejs/db — The database client.
+ *
+ * The `zite` object is generated per-project by `zite sync` and provides
+ * typed access to your Zite Database tables.
+ *
+ * Usage:
+ *   import { zite } from 'zitejs/db';
+ *   const users = await zite.users.findMany();
+ *
+ * The actual `zite` object is generated into `.zite/db.ts` in your project.
+ * This module re-exports it. If you see type errors, run `zite sync` to
+ * regenerate the client.
+ */
+
+export declare const zite: Record<
+  string,
+  {
+    findMany(params?: Record<string, unknown>): Promise<{
+      records: Record<string, unknown>[];
+      hasMore: boolean;
+    }>;
+    findOne(id: string): Promise<Record<string, unknown>>;
+    create(data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    update(
+      id: string,
+      data: Record<string, unknown>,
+    ): Promise<Record<string, unknown>>;
+    delete(id: string): Promise<void>;
+    bulkCreate(
+      items: Record<string, unknown>[],
+    ): Promise<Record<string, unknown>[]>;
+  }
+>;

package/db/index.js

@@ -0,0 +1,23 @@
+// zitejs/db — runtime stub.
+// The actual `zite` object is generated by `zite sync` into .zite/db.ts.
+// This stub exists so the package resolves; the generated code overrides it.
+export const zite = new Proxy(
+  {},
+  {
+    get(_, tableName) {
+      const notGenerated = () => {
+        throw new Error(
+          `zite.${String(tableName)} is not available. Run \`zite sync\` to generate the database client.`,
+        );
+      };
+      return {
+        findMany: notGenerated,
+        findOne: notGenerated,
+        create: notGenerated,
+        update: notGenerated,
+        delete: notGenerated,
+        bulkCreate: notGenerated,
+      };
+    },
+  },
+);

package/package.json

@@ -1,13 +1,46 @@
 {
   "name": "zitejs",
-  "version": "0.0.1",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.1.0",
+  "description": "The Zite framework — build apps on Zite Database",
+  "type": "module",
+  "exports": {
+    "./db": {
+      "types": "./db/index.d.ts",
+      "default": "./db/index.js"
+    },
+    "./api": {
+      "types": "./api/index.d.ts",
+      "default": "./api/index.js"
+    },
+    "./auth": {
+      "types": "./auth/index.d.ts",
+      "default": "./auth/index.js"
+    },
+    "./upload": {
+      "types": "./upload/index.d.ts",
+      "default": "./upload/index.js"
+    },
+    "./pdf": {
+      "types": "./pdf/index.d.ts",
+      "default": "./pdf/index.js"
+    },
+    "./schedules": {
+      "types": "./schedules/index.d.ts",
+      "default": "./schedules/index.js"
+    }
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "Official Zite JavaScript SDK",
-  "types": "index.d.ts"
+  "files": [
+    "db",
+    "api",
+    "auth",
+    "upload",
+    "pdf",
+    "schedules"
+  ],
+  "keywords": ["zite", "zitejs", "framework", "database", "vibe-coding"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zite/zitejs"
+  }
 }

package/pdf/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * zitejs/pdf — PDF generation.
+ *
+ * Usage:
+ *   import { ZitePdf } from 'zitejs/pdf';
+ *   const pdf = new ZitePdf();
+ *   const result = await pdf.generate({ html: '<h1>Hello</h1>' });
+ */
+
+export declare class ZitePdf {
+  generate(options: { html: string; [key: string]: unknown }): Promise<{
+    url: string;
+    [key: string]: unknown;
+  }>;
+}

package/pdf/index.js

@@ -0,0 +1,6 @@
+// zitejs/pdf — runtime stub.
+export class ZitePdf {
+  async generate() {
+    throw new Error('ZitePdf is not available outside the Zite sandbox.');
+  }
+}

package/schedules/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * zitejs/schedules — Scheduled task helpers.
+ *
+ * Usage:
+ *   import { ZiteSchedule } from 'zitejs/schedules';
+ */
+
+export declare class ZiteSchedule {
+  static create(config: {
+    name: string;
+    cron: string;
+    endpoint: string;
+    input?: Record<string, unknown>;
+  }): Promise<{ id: string }>;
+
+  static delete(id: string): Promise<void>;
+
+  static list(): Promise<Array<{ id: string; name: string; cron: string }>>;
+}

package/schedules/index.js

@@ -0,0 +1,12 @@
+// zitejs/schedules — runtime stub.
+export class ZiteSchedule {
+  static async create() {
+    throw new Error('ZiteSchedule is not available outside the Zite sandbox.');
+  }
+  static async delete() {
+    throw new Error('ZiteSchedule is not available outside the Zite sandbox.');
+  }
+  static async list() {
+    throw new Error('ZiteSchedule is not available outside the Zite sandbox.');
+  }
+}

package/upload/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * zitejs/upload — File upload helpers.
+ *
+ * Usage:
+ *   import { useUpload } from 'zitejs/upload';
+ */
+
+export declare function useUpload(): {
+  upload: (file: File) => Promise<{ url: string }>;
+  isUploading: boolean;
+};

package/upload/index.js

@@ -0,0 +1,4 @@
+// zitejs/upload — runtime stub.
+export function useUpload() {
+  return { upload: async () => ({ url: '' }), isUploading: false };
+}

package/index.d.ts

@@ -1 +0,0 @@
-export {};

package/index.js

@@ -1 +0,0 @@
-module.exports = {};