@fayz-ai/plugin-tasks 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,46 @@
+# @fayz-ai/plugin-tasks
+
+> A task list that lives in your topbar, in every app you compose.
+
+[![npm](https://img.shields.io/npm/v/@fayz-ai/plugin-tasks.svg)](https://www.npmjs.com/package/@fayz-ai/plugin-tasks)
+[![license](https://img.shields.io/npm/l/@fayz-ai/plugin-tasks.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
+
+Work happens between the records. A salon owner needs to "call the supplier," a clinic admin needs to "follow up on lab results" — small things that never fit neatly into a booking or an invoice. `plugin-tasks` gives every Fayz app a lightweight, always-available task list: a topbar button that opens a drawer for quick-add, statuses, priorities, due dates, labels, and assignees.
+
+It's deliberately small and zero-config. Drop it in and it owns its own tables (via a bundled migration), picks Supabase or an in-memory mock automatically, and exposes its summary to the AI assistant — so "what's overdue?" just works. No page to wire, no nav slot to claim; tasks ride along with whatever vertical you compose.
+
+## What's inside
+- **Topbar task drawer** — a widget mounted at `shell.topbar.end` for quick-add and review, available on every page.
+- **Task model** — title, description, status (todo / in progress / done / cancelled), priority (low / medium / high / urgent), due date, labels, assignee, and subtasks (parent/child).
+- **AI tool** — `getTasksSummary` reports totals, overdue, due-today, and breakdowns by status and priority.
+- **Bundled migration** — creates `tsk_tasks` and `tsk_labels` with tenant-scoped RLS, so it's self-installing.
+- **Settings tab** + i18n, with a Supabase-or-mock data provider chosen automatically.
+- Configurable labels and a default priority for new tasks.
+
+## Install
+```bash
+npm install @fayz-ai/plugin-tasks
+```
+Peer deps: `react`, `react-dom`. Runtime deps include `@fayz-ai/core`, `@fayz-ai/ui`, and `@fayz-ai/saas`.
+
+## Usage
+```tsx
+import { defineSaas } from '@fayz-ai/saas'
+import { createTasksPlugin } from '@fayz-ai/plugin-tasks'
+
+export const app = defineSaas({
+  // ...
+  plugins: [
+    createTasksPlugin({
+      defaultPriority: 'medium',
+      labels: { drawerTitle: 'To-dos', quickAddPlaceholder: 'Add a to-do...' },
+    }),
+  ],
+})
+```
+
+## Part of the Fayz SDK
+`plugin-tasks` is the lightweight companion plugin: no navigation of its own, it simply adds a task surface to any app built with `@fayz-ai/saas`. It complements heavier plugins like `@fayz-ai/plugin-agenda` and `@fayz-ai/plugin-financial` by capturing the loose work around them.
+
+## Roadmap & contributing
+Built and evolving in the open. See the [Fayz SDK roadmap](../../docs/ROADMAP.md#plugin-tasks) for current gaps, missing features, and good first issues.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fayz-ai/plugin-tasks",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Fayz SDK — plugin-tasks plugin",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,9 +25,9 @@
   "dependencies": {
     "lucide-react": "^0.400.0",
     "zustand": "^4.5.0",
-    "@fayz-ai/core": "^0.1.6",
-    "@fayz-ai/saas": "^0.1.6",
-    "@fayz-ai/ui": "^0.1.6"
+    "@fayz-ai/core": "^0.1.7",
+    "@fayz-ai/ui": "^0.1.7",
+    "@fayz-ai/saas": "^0.1.7"
   },
   "devDependencies": {
     "@types/react": "^18.3.0",

package/src/migrations/001_tasks_base.sql

@@ -42,16 +42,24 @@ CREATE INDEX IF NOT EXISTS idx_tsk_tasks_assigned ON public.tsk_tasks(assigned_t
 CREATE INDEX IF NOT EXISTS idx_tsk_tasks_due ON public.tsk_tasks(tenant_id, due_date)
   WHERE due_date IS NOT NULL;
 
--- RLS policies for tsk_tasks
+-- RLS policies for tsk_tasks (idempotent — DROP IF EXISTS before CREATE)
+DROP POLICY IF EXISTS tsk_tasks_select ON public.tsk_tasks;
 CREATE POLICY tsk_tasks_select ON public.tsk_tasks FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_tasks_insert ON public.tsk_tasks;
 CREATE POLICY tsk_tasks_insert ON public.tsk_tasks FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_tasks_update ON public.tsk_tasks;
 CREATE POLICY tsk_tasks_update ON public.tsk_tasks FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_tasks_delete ON public.tsk_tasks;
 CREATE POLICY tsk_tasks_delete ON public.tsk_tasks FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
 GRANT SELECT, INSERT, UPDATE, DELETE ON public.tsk_tasks TO authenticated;
 
--- RLS policies for tsk_labels
+-- RLS policies for tsk_labels (idempotent)
+DROP POLICY IF EXISTS tsk_labels_select ON public.tsk_labels;
 CREATE POLICY tsk_labels_select ON public.tsk_labels FOR SELECT TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_labels_insert ON public.tsk_labels;
 CREATE POLICY tsk_labels_insert ON public.tsk_labels FOR INSERT TO authenticated WITH CHECK (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_labels_update ON public.tsk_labels;
 CREATE POLICY tsk_labels_update ON public.tsk_labels FOR UPDATE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
+DROP POLICY IF EXISTS tsk_labels_delete ON public.tsk_labels;
 CREATE POLICY tsk_labels_delete ON public.tsk_labels FOR DELETE TO authenticated USING (tenant_id IN (SELECT public.user_tenant_ids()));
 GRANT SELECT, INSERT, UPDATE, DELETE ON public.tsk_labels TO authenticated;