@notis_ai/cli 0.2.0-beta.16.1 → 0.2.0

package/template/packages/notis-sdk/src/hooks/useUpsertDocument.ts

@@ -1,57 +0,0 @@
-'use client';
-
-import { useCallback, useState } from 'react';
-import { useNotisRuntime } from '../provider';
-import type { DocumentRecord } from '../runtime';
-
-interface UpsertArgs {
-  databaseSlug: string;
-  documentId?: string;
-  title?: string;
-  properties?: Record<string, unknown>;
-}
-
-interface UseUpsertDocumentResult {
-  upsert: (args: UpsertArgs) => Promise<DocumentRecord>;
-  loading: boolean;
-  error: Error | null;
-}
-
-/**
- * Create or update a document in a Notis database.
- *
- * ```tsx
- * const { upsert, loading } = useUpsertDocument();
- * await upsert({ databaseSlug: 'tasks', title: 'New task', properties: { status: 'Open' } });
- * ```
- */
-export function useUpsertDocument(): UseUpsertDocumentResult {
-  const runtime = useNotisRuntime();
-  const [loading, setLoading] = useState(false);
-  const [error, setError] = useState<Error | null>(null);
-
-  const upsert = useCallback(
-    async (args: UpsertArgs): Promise<DocumentRecord> => {
-      if (!runtime) {
-        throw new Error('Notis runtime not available. Ensure NotisProvider is mounted.');
-      }
-
-      setLoading(true);
-      setError(null);
-
-      try {
-        const result = await runtime.upsertDocument(args);
-        return result.document;
-      } catch (err) {
-        const e = err instanceof Error ? err : new Error(String(err));
-        setError(e);
-        throw e;
-      } finally {
-        setLoading(false);
-      }
-    },
-    [runtime],
-  );
-
-  return { upsert, loading, error };
-}

package/template/packages/notis-sdk/src/index.ts

@@ -1,47 +0,0 @@
-/**
- * @notis/sdk - The Notis App SDK
- *
- * Public API for building Notis apps. Import hooks and the provider from
- * this entrypoint. For configuration, use `@notis/sdk/config`. For the
- * Vite config builder, use `@notis/sdk/vite`.
- */
-
-// Provider
-export { NotisProvider, useNotisRuntime } from './provider';
-
-// Hooks
-export { useNotis } from './hooks/useNotis';
-export { useDatabase } from './hooks/useDatabase';
-export { useDocument } from './hooks/useDocument';
-export { useUpsertDocument } from './hooks/useUpsertDocument';
-export { useTool } from './hooks/useTool';
-export { useTools } from './hooks/useTools';
-export { useCollectionItems } from './hooks/useCollectionItem';
-export { useNotisNavigation } from './hooks/useNotisNavigation';
-export { useBackend } from './hooks/useBackend';
-export { useAppState } from './hooks/useAppState';
-
-// Property extraction helpers
-export {
-  extractText,
-  extractSelect,
-  extractDate,
-  extractNumber,
-  extractCheckbox,
-  extractMultiSelect,
-  extractRelation,
-  docTitle,
-} from './helpers';
-
-// Types (re-exported for convenience)
-export type {
-  AppDescriptor,
-  CollectionItem,
-  DatabaseDescriptor,
-  DatabaseProperty,
-  DocumentRecord,
-  NotisRuntime,
-  QueryFilter,
-  RouteDescriptor,
-  ToolDescriptor,
-} from './runtime';

package/template/packages/notis-sdk/src/provider.tsx

@@ -1,44 +0,0 @@
-'use client';
-
-import React, { createContext, useContext, useEffect, useState, type ReactNode } from 'react';
-import type { NotisRuntime } from './runtime';
-import { getRuntime } from './runtime';
-
-const NotisContext = createContext<NotisRuntime | null>(null);
-
-/**
- * Provides the Notis runtime context to all child components. Place this in
- * your root layout so that hooks like useDatabase, useTool, etc. can access
- * the platform bridge.
- *
- * During `next dev` (no runtime injected), hooks return safe defaults (empty
- * arrays, null values). During `notis apps preview` and in the portal, the
- * runtime is fully functional.
- */
-export function NotisProvider({ children, runtime }: { children: ReactNode; runtime?: NotisRuntime | null }) {
-  const [resolvedRuntime, setResolvedRuntime] = useState<NotisRuntime | null>(runtime ?? null);
-
-  useEffect(() => {
-    // If runtime was passed as a prop (portal component rendering), use it directly.
-    // Otherwise fall back to window.__NOTIS_RUNTIME__ (local dev / preview).
-    if (runtime !== undefined) {
-      setResolvedRuntime(runtime);
-    } else {
-      setResolvedRuntime(getRuntime());
-    }
-  }, [runtime]);
-
-  return (
-    <NotisContext.Provider value={resolvedRuntime}>
-      {children}
-    </NotisContext.Provider>
-  );
-}
-
-/**
- * Returns the raw NotisRuntime or null if not yet available.
- * Prefer the typed hooks (useDatabase, useTool, etc.) over this.
- */
-export function useNotisRuntime(): NotisRuntime | null {
-  return useContext(NotisContext);
-}

package/template/packages/notis-sdk/src/runtime.ts

@@ -1,159 +0,0 @@
-/**
- * NotisRuntime is the bridge between app code running in the browser and the
- * Notis platform. It is injected as `window.__NOTIS_RUNTIME__` into every app
- * page -- both in local preview (with mock implementations) and in the portal
- * (with real server-backed implementations).
- *
- * App code should never access `window.__NOTIS_RUNTIME__` directly. Instead,
- * use the hooks from `@notis/sdk` (useDatabase, useTool, etc.) which read
- * from the NotisProvider context.
- */
-
-// ---------------------------------------------------------------------------
-// Database types
-// ---------------------------------------------------------------------------
-
-export interface DatabaseProperty {
-  name: string;
-  type: 'title' | 'rich_text' | 'number' | 'checkbox' | 'date' | 'select' | 'multi_select' | 'status' | 'relation' | 'formula' | 'files';
-  description?: string;
-  options?: Array<{ name: string; id?: string }>;
-}
-
-export interface DatabaseDescriptor {
-  slug: string;
-  title: string;
-  description?: string | null;
-  icon?: string | null;
-  properties: DatabaseProperty[];
-}
-
-export interface DocumentRecord {
-  id: string;
-  title: string;
-  properties: Record<string, unknown>;
-  icon?: string | null;
-  databaseSlug?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Tool types
-// ---------------------------------------------------------------------------
-
-export interface ToolDescriptor {
-  name: string;
-  description?: string;
-  input_schema?: Record<string, unknown>;
-}
-
-// ---------------------------------------------------------------------------
-// Route types
-// ---------------------------------------------------------------------------
-
-export interface RouteDescriptor {
-  slug: string;
-  path: string;
-  name: string;
-  icon?: string | null;
-  default?: boolean;
-  collection?: {
-    database: string;
-    titleProperty: string;
-  } | null;
-}
-
-export interface CollectionItem {
-  id: string;
-  title: string;
-  icon?: string | null;
-}
-
-// ---------------------------------------------------------------------------
-// App descriptor
-// ---------------------------------------------------------------------------
-
-export interface AppDescriptor {
-  id: string;
-  name: string;
-  icon?: string | null;
-  description?: string | null;
-}
-
-// ---------------------------------------------------------------------------
-// Query types
-// ---------------------------------------------------------------------------
-
-export interface QueryFilter {
-  filters?: Array<{
-    property: string;
-    operator: string;
-    value: unknown;
-  }>;
-  sorts?: Array<{
-    property: string;
-    direction: 'asc' | 'desc';
-  }>;
-  page_size?: number;
-}
-
-// ---------------------------------------------------------------------------
-// NotisRuntime -- the window.__NOTIS_RUNTIME__ contract
-// ---------------------------------------------------------------------------
-
-export interface NotisRuntime {
-  app: AppDescriptor;
-  route: RouteDescriptor;
-  databases: DatabaseDescriptor[];
-
-  navigate?: (payload: { kind: string; [key: string]: unknown }) => void;
-
-  listTools(): Promise<ToolDescriptor[]>;
-  callTool(name: string, args?: Record<string, unknown>): Promise<unknown>;
-
-  queryDatabase(args: {
-    databaseSlug: string;
-    query?: QueryFilter;
-    offset?: number;
-  }): Promise<{ documents: DocumentRecord[] }>;
-
-  getDocument(args: {
-    documentId: string;
-  }): Promise<DocumentRecord>;
-
-  upsertDocument(args: {
-    databaseSlug: string;
-    documentId?: string;
-    title?: string;
-    properties?: Record<string, unknown>;
-  }): Promise<{ status: string; document: DocumentRecord }>;
-
-  listCollectionItems(args?: {
-    databaseSlug?: string;
-    pageSize?: number;
-  }): Promise<{ items: CollectionItem[] }>;
-
-  request(path: string, options?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
-  }): Promise<unknown>;
-}
-
-// ---------------------------------------------------------------------------
-// Globals
-// ---------------------------------------------------------------------------
-
-declare global {
-  interface Window {
-    __NOTIS_RUNTIME__?: NotisRuntime;
-  }
-}
-
-/**
- * Read the injected runtime from the window. Returns null during SSR or if the
- * runtime hasn't been injected yet (e.g. during `next dev` without preview).
- */
-export function getRuntime(): NotisRuntime | null {
-  if (typeof window === 'undefined') return null;
-  return window.__NOTIS_RUNTIME__ ?? null;
-}

package/template/packages/notis-sdk/src/styles.css

@@ -1,123 +0,0 @@
-/**
- * Notis theme CSS variables.
- *
- * These match the portal's globals.css so that apps rendered inside the portal
- * iframe have identical styling. Import this in your root layout:
- *
- *   import '@notis/sdk/styles.css';
- *
- * Then use Tailwind classes as normal -- shadcn components will pick up these
- * variables automatically.
- */
-
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-@layer base {
-  :root {
-    --background: 0 0% 100%;
-    --foreground: 222.2 84% 4.9%;
-    --card: 0 0% 100%;
-    --card-foreground: 222.2 84% 4.9%;
-    --popover: 0 0% 100%;
-    --popover-foreground: 222.2 84% 4.9%;
-    --primary: 222.2 47.4% 11.2%;
-    --primary-foreground: 210 40% 98%;
-    --secondary: 210 40% 96.1%;
-    --secondary-foreground: 222.2 47.4% 11.2%;
-    --muted: 210 40% 96.1%;
-    --muted-foreground: 0 0% 46.9%;
-    --accent: 210 40% 96.1%;
-    --accent-foreground: 222.2 47.4% 11.2%;
-    --destructive: 0 84.2% 60.2%;
-    --destructive-foreground: 210 40% 98%;
-    --border: 214.3 31.8% 91.4%;
-    --input: 214.3 31.8% 91.4%;
-    --ring: 222.2 84% 4.9%;
-    --radius: 0.5rem;
-    --sidebar-background: 0 0% 7.5%;
-    --sidebar-foreground: 240 4.8% 95.9%;
-    --sidebar-primary: 0 0% 7.5%;
-    --sidebar-primary-foreground: 240 4.8% 95.9%;
-    --sidebar-accent: 240 3.7% 15.9%;
-    --sidebar-accent-foreground: 240 4.8% 95.9%;
-    --sidebar-border: 0 0% 23.5%;
-    --sidebar-ring: 217.2 91.2% 59.8%;
-    --chart-1: 210 100% 49%;
-    --chart-2: 173 58% 39%;
-    --chart-3: 197 37% 24%;
-    --chart-4: 43 74% 66%;
-    --chart-5: 27 87% 67%;
-    --code-block-background: #f6f6f6;
-    --code-block-foreground: #27272a;
-    --portal-page-max-width: 1100px;
-    --portal-page-gutter-mobile: 1rem;
-    --portal-page-gutter-desktop: 1rem;
-    --portal-page-top-mobile: 1rem;
-    --portal-page-top-desktop: 1.5rem;
-    --portal-surface-pad-x-mobile: 1rem;
-    --portal-surface-pad-x-desktop: 1.5rem;
-    --portal-surface-pad-bottom: 1.5rem;
-  }
-
-  .dark {
-    --background: 0 0% 13%;
-    --foreground: 210 40% 98%;
-    --card: 0 0% 13%;
-    --card-foreground: 210 40% 98%;
-    --popover: 0 0% 13%;
-    --popover-foreground: 210 40% 98%;
-    --primary: 210 40% 98%;
-    --primary-foreground: 222.2 47.4% 11.2%;
-    --secondary: 0 0% 18%;
-    --secondary-foreground: 210 40% 98%;
-    --muted: 0 0% 18%;
-    --muted-foreground: 0 0% 65.1%;
-    --accent: 0 0% 18%;
-    --accent-foreground: 210 40% 98%;
-    --destructive: 0 84.2% 60.2%;
-    --destructive-foreground: 210 40% 98%;
-    --border: 0 0% 23.5%;
-    --input: 0 0% 23.5%;
-    --ring: 212.7 26.8% 83.9%;
-    --sidebar-background: 0 0% 7.5%;
-    --sidebar-foreground: 240 4.8% 95.9%;
-    --sidebar-primary: 224.3 76.3% 48%;
-    --sidebar-primary-foreground: 0 0% 100%;
-    --sidebar-accent: 240 3.7% 15.9%;
-    --sidebar-accent-foreground: 240 4.8% 95.9%;
-    --sidebar-border: 0 0% 23.5%;
-    --sidebar-ring: 217.2 91.2% 59.8%;
-    --chart-1: 210 100% 49%;
-    --chart-2: 160 60% 45%;
-    --chart-3: 30 80% 55%;
-    --chart-4: 280 65% 60%;
-    --chart-5: 340 75% 55%;
-    --code-block-background: #1e1e1e;
-    --code-block-foreground: #e4e4e7;
-  }
-}
-
-@layer base {
-  * {
-    @apply border-border;
-  }
-  body {
-    @apply bg-background text-foreground;
-  }
-}
-
-@layer components {
-  .notis-app-shell {
-    @apply mx-auto w-full max-w-[var(--portal-page-max-width)] px-4 py-6 md:px-4 md:py-8;
-  }
-
-  .notis-app-surface {
-    @apply rounded-2xl border border-border bg-card text-card-foreground shadow-sm;
-  }
-
-  .notis-app-section {
-    @apply p-5 md:p-6;
-  }
-}

package/template/packages/notis-sdk/src/ui.ts

@@ -1,15 +0,0 @@
-/**
- * @notis/sdk/ui - Re-exported shadcn components for Notis apps.
- *
- * Apps include shadcn via their own `components.json` and `@/components/ui/*`
- * imports. This entrypoint is provided as a convenience for apps that want to
- * import directly from the SDK without setting up shadcn locally.
- *
- * For now, this is a placeholder. The scaffold template sets up shadcn
- * directly in the app project, so components come from `@/components/ui/*`.
- * This file can be expanded later to re-export a curated set of components
- * pre-themed for Notis.
- */
-
-// Placeholder -- apps use shadcn directly via their project's components/ui/
-export {};

package/template/packages/notis-sdk/src/vite.ts

@@ -1,54 +0,0 @@
-/**
- * Vite config builder for Notis apps.
- *
- * Usage:
- * ```ts
- * // vite.config.ts
- * import { notisViteConfig } from '@notis/sdk/vite';
- * import appConfig from './notis.config';
- * export default notisViteConfig(appConfig);
- * ```
- *
- * Produces a library-mode ES module bundle with React externalized.
- * Output: .notis/output/bundle/app.js + app.css
- */
-
-import type { NotisAppConfig } from './config';
-
-export function notisViteConfig(appConfig: NotisAppConfig) {
-  return {
-    plugins: [
-      // @vitejs/plugin-react is added by the consumer's vite.config.ts
-      // or auto-detected. We provide the config shape only.
-    ],
-    build: {
-      lib: {
-        entry: '.notis/_entry.tsx',
-        formats: ['es'] as const,
-        fileName: () => 'app.js',
-      },
-      rollupOptions: {
-        external: ['react', 'react-dom', 'react/jsx-runtime'],
-        output: {
-          globals: {
-            react: 'window.React',
-            'react-dom': 'window.ReactDOM',
-            'react/jsx-runtime': 'window.React',
-          },
-          assetFileNames: 'app[extname]',
-        },
-      },
-      outDir: '.notis/output/bundle',
-      emptyOutDir: true,
-      cssCodeSplit: false,
-    },
-    resolve: {
-      alias: {
-        '@': process.cwd(),
-      },
-    },
-    define: {
-      'process.env.NODE_ENV': JSON.stringify('production'),
-    },
-  };
-}

package/template/packages/notis-sdk/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"]
-}

package/template/postcss.config.mjs

@@ -1,8 +0,0 @@
-/** @type {import('postcss-load-config').Config} */
-const config = {
-  plugins: {
-    tailwindcss: {},
-  },
-};
-
-export default config;

package/template/tailwind.config.ts

@@ -1,58 +0,0 @@
-import type { Config } from 'tailwindcss';
-import tailwindAnimate from 'tailwindcss-animate';
-
-const config: Config = {
-  darkMode: ['class'],
-  content: [
-    './app/**/*.{ts,tsx}',
-    './components/**/*.{ts,tsx}',
-    './lib/**/*.{ts,tsx}',
-  ],
-  theme: {
-    extend: {
-      colors: {
-        border: 'hsl(var(--border))',
-        input: 'hsl(var(--input))',
-        ring: 'hsl(var(--ring))',
-        background: 'hsl(var(--background))',
-        foreground: 'hsl(var(--foreground))',
-        primary: {
-          DEFAULT: 'hsl(var(--primary))',
-          foreground: 'hsl(var(--primary-foreground))',
-        },
-        secondary: {
-          DEFAULT: 'hsl(var(--secondary))',
-          foreground: 'hsl(var(--secondary-foreground))',
-        },
-        destructive: {
-          DEFAULT: 'hsl(var(--destructive))',
-          foreground: 'hsl(var(--destructive-foreground))',
-        },
-        muted: {
-          DEFAULT: 'hsl(var(--muted))',
-          foreground: 'hsl(var(--muted-foreground))',
-        },
-        accent: {
-          DEFAULT: 'hsl(var(--accent))',
-          foreground: 'hsl(var(--accent-foreground))',
-        },
-        popover: {
-          DEFAULT: 'hsl(var(--popover))',
-          foreground: 'hsl(var(--popover-foreground))',
-        },
-        card: {
-          DEFAULT: 'hsl(var(--card))',
-          foreground: 'hsl(var(--card-foreground))',
-        },
-      },
-      borderRadius: {
-        lg: 'var(--radius)',
-        md: 'calc(var(--radius) - 2px)',
-        sm: 'calc(var(--radius) - 4px)',
-      },
-    },
-  },
-  plugins: [tailwindAnimate],
-};
-
-export default config;

package/template/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "incremental": true,
-    "paths": {
-      "@/*": ["./*"]
-    }
-  },
-  "include": ["**/*.ts", "**/*.tsx"],
-  "exclude": ["node_modules"]
-}

package/template/vite.config.ts

@@ -1,10 +0,0 @@
-import { notisViteConfig } from '@notis/sdk/vite';
-import react from '@vitejs/plugin-react';
-import appConfig from './notis.config';
-
-const config = notisViteConfig(appConfig);
-
-export default {
-  ...config,
-  plugins: [react(), ...(config.plugins || [])],
-};