TasGrid Parent App Simulator

1. Available Routes:

• /embed/notes: Renders the full notepad/editor.
• /embed/notes?noteId=XXX: Renders a specific note directly.
• /embed/quick-add: Renders a standalone task creation form.

2. Programmatic Creation (TasGrid SDK):

The recommended way to create entries is using the tasgrid-sdk.js module. This ensures all TasGrid-specific defaults and date logic (like urgency decay) are handled correctly.

Setup:

import { createTasgridTask, createTasgridNote } from 'https://tasgrid.ccllc.pro/tasgrid-sdk.js';

const task = await createTasgridTask(pb, {
    title: "Urgent Task",
    urgency: 10,   // Automated: 10=Today, 5=Next Week, 1=Six Months
    priority: 8,   // 1-10
    size: 3,       // Default: 3 (1 hour). Range 0-10.
    tags: ["external"],
    owner: "USER_ID" // Optional
});

const note = await createTasgridNote(pb, {
    title: "Project Brief",
    content: "<p>HTML content here...</p>",
    tags: ["documentation"],
    isPrivate: false,
    tasks: [] // Optional: Array of Task IDs to link
});

3. Authentication Protocol:

The parent application must send a postMessage to the iframe immediately after the iframe loads (or whenever auth state changes). Since iframes reset their internal state on navigation, you should always sync auth on the onload event.

Example using vanilla JS:

// 1. Define sync function
function syncAuth(iframe) {
    iframe.contentWindow.postMessage({
        type: "TASGRID_AUTH",
        token: pb.authStore.token,
        user: pb.authStore.model
    }, "*");
}

// 2. Attach to iframe (either in HTML or via JS)
// <iframe onload="syncAuth(this)" src="..."></iframe>

4. Responsiveness:

Both routes are designed to be fluid. Ensure your iframe container has defined dimensions; the content will expand to fill it.