@the-portland-company/devnotes 0.1.0 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
 # @the-portland-company/devnotes
 
-Forge-backed DevNotes and bug reporting for server-capable React and Next.js apps.
+Forge-backed DevNotes and bug reporting for server-capable React, Next.js, Express, and Deno apps.
 
-This package is Forge-only. It does not ship a local database, SQL schema, Supabase adapter, or migration path.
+This package is Forge-only. It ships the Focus Forge proxy implementation for supported server runtimes and does not include a local database, SQL schema, Supabase adapter, or fallback persistence layer.
 
 ## Install
 
@@ -35,13 +35,14 @@ Then wire the generated wrapper component to your auth token source and implemen
 - `@the-portland-company/devnotes`
 - `@the-portland-company/devnotes/next`
 - `@the-portland-company/devnotes/express`
+- `@the-portland-company/devnotes/deno`
 - `@the-portland-company/devnotes/styles.css`
 
 ## What this package ships
 
 - React UI components for in-app bug reporting and DevNotes overlays
 - A browser client that talks to your host app at `/api/devnotes`
-- Next.js and Express proxy helpers for server-side routing
+- Forge-native server helpers for Next.js, Express, and Deno
 - A `devnotes-setup` CLI that copies starter integration templates into a host app
 
 ## Client usage
@@ -72,16 +73,94 @@ export function AppDevNotes({ children }) {
 
 - `@the-portland-company/devnotes/next`
 - `@the-portland-company/devnotes/express`
+- `@the-portland-company/devnotes/deno`
 
-These provide request-routing helpers for a host proxy. They do not implement Forge access for you; your app backend remains responsible for the Forge integration.
+These helpers implement the DevNotes-to-Forge proxy path for you. Your app provides the authenticated host user and Forge configuration; the package owns the DevNotes routing, project discovery, and Forge API integration.
 
 ## Host app requirements
 
 - Expose a server-side proxy at `/api/devnotes`
 - Authenticate the current user in the host app
-- Return a bearer token from `getAuthToken()`
+- Return a bearer token from `getAuthToken()` on the browser side
+- Resolve the current user server-side with `getCurrentUser(request)`
 - Keep Forge credentials server-side only
-- Translate DevNotes operations into real Forge API requests
+
+## Deno usage
+
+```ts
+import { createDenoDevNotesHandler } from '@the-portland-company/devnotes/deno';
+
+const devNotesHandler = createDenoDevNotesHandler({
+  basePath: '/api/devnotes',
+  forge: {
+    baseUrl: Deno.env.get('FOCUS_FORGE_BASE_URL')!,
+    pat: Deno.env.get('FOCUS_FORGE_PAT')!,
+    projectName: Deno.env.get('FOCUS_FORGE_PROJECT_NAME') || null,
+  },
+  corsHeaders: {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Headers': 'authorization, content-type',
+    'Access-Control-Allow-Methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS',
+  },
+  async getCurrentUser(request) {
+    const authHeader = request.headers.get('authorization');
+    if (!authHeader) return null;
+    return { id: 'user-id', email: 'person@example.com', fullName: 'Person Example' };
+  },
+});
+
+Deno.serve((request) => {
+  if (new URL(request.url).pathname.startsWith('/api/devnotes')) {
+    return devNotesHandler(request);
+  }
+  return new Response('Not found', { status: 404 });
+});
+```
+
+## Next.js usage
+
+```ts
+import { createNextDevNotesHandler } from '@the-portland-company/devnotes/next';
+
+const handler = createNextDevNotesHandler({
+  forge: {
+    baseUrl: process.env.FOCUS_FORGE_BASE_URL!,
+    pat: process.env.FOCUS_FORGE_PAT!,
+    projectName: process.env.FOCUS_FORGE_PROJECT_NAME || null,
+  },
+  async getCurrentUser(request) {
+    const authHeader = request.headers.get('authorization');
+    if (!authHeader) return null;
+    return { id: 'user-id', email: 'person@example.com' };
+  },
+});
+
+export const GET = handler;
+export const POST = handler;
+export const PATCH = handler;
+export const DELETE = handler;
+export const PUT = handler;
+export const OPTIONS = handler;
+```
+
+## Express usage
+
+```ts
+import { createExpressDevNotesHandler } from '@the-portland-company/devnotes/express';
+
+export const devNotesProxy = createExpressDevNotesHandler({
+  forge: {
+    baseUrl: process.env.FOCUS_FORGE_BASE_URL!,
+    pat: process.env.FOCUS_FORGE_PAT!,
+    projectName: process.env.FOCUS_FORGE_PROJECT_NAME || null,
+  },
+  async getCurrentUser(request) {
+    const authHeader = request.headers.get('authorization');
+    if (!authHeader) return null;
+    return { id: 'user-id', email: 'person@example.com' };
+  },
+});
+```
 
 ## Storage model
 

package/dist/index.d.mts

@@ -1,7 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { D as DevNotesClientAdapter, a as DevNotesUser, b as DevNotesConfig, B as BugReport, c as BugReportType, T as TaskList, d as BugReportCreator, e as DevNotesCapabilities, f as DevNotesAppLinkStatus, N as NotifyEvent, A as AiProvider, g as DevNotesRole, h as DevNotesClientOptions, i as BugCaptureContext } from './types-xqGNcAbZ.mjs';
-export { j as AiAssistResult, k as AiConversationMessage, l as BugReportCreateData, m as BugReportMessage, n as DevNotesLinkAppInput } from './types-xqGNcAbZ.mjs';
+import { D as DevNotesClientAdapter, a as DevNotesUser, b as DevNotesConfig, B as BugReport, c as BugReportType, T as TaskList, d as BugReportCreator, N as NotifyEvent, A as AiProvider, e as DevNotesRole, f as BugCaptureContext } from './types-CBHExs2F.mjs';
+export { g as AiAssistResult, h as AiConversationMessage, i as BugReportCreateData, j as BugReportMessage } from './types-CBHExs2F.mjs';
+import { D as DevNotesCapabilities, a as DevNotesAppLinkStatus, b as DevNotesClientOptions } from './types-CrmObeqp.mjs';
+export { c as DevNotesLinkAppInput } from './types-CrmObeqp.mjs';
 
 type DevNotesContextValue = {
     isEnabled: boolean;

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { D as DevNotesClientAdapter, a as DevNotesUser, b as DevNotesConfig, B as BugReport, c as BugReportType, T as TaskList, d as BugReportCreator, e as DevNotesCapabilities, f as DevNotesAppLinkStatus, N as NotifyEvent, A as AiProvider, g as DevNotesRole, h as DevNotesClientOptions, i as BugCaptureContext } from './types-xqGNcAbZ.js';
-export { j as AiAssistResult, k as AiConversationMessage, l as BugReportCreateData, m as BugReportMessage, n as DevNotesLinkAppInput } from './types-xqGNcAbZ.js';
+import { D as DevNotesClientAdapter, a as DevNotesUser, b as DevNotesConfig, B as BugReport, c as BugReportType, T as TaskList, d as BugReportCreator, N as NotifyEvent, A as AiProvider, e as DevNotesRole, f as BugCaptureContext } from './types-DqIxvo5g.js';
+export { g as AiAssistResult, h as AiConversationMessage, i as BugReportCreateData, j as BugReportMessage } from './types-DqIxvo5g.js';
+import { D as DevNotesCapabilities, a as DevNotesAppLinkStatus, b as DevNotesClientOptions } from './types-CrmObeqp.js';
+export { c as DevNotesLinkAppInput } from './types-CrmObeqp.js';
 
 type DevNotesContextValue = {
     isEnabled: boolean;

package/dist/{router-Bt8qbFfY.d.ts → router-3PUkM5T-.d.ts}

@@ -1,4 +1,5 @@
-import { e as DevNotesCapabilities, f as DevNotesAppLinkStatus, n as DevNotesLinkAppInput, B as BugReport, l as BugReportCreateData, c as BugReportType, T as TaskList, m as BugReportMessage, d as BugReportCreator, k as AiConversationMessage, i as BugCaptureContext, j as AiAssistResult } from './types-xqGNcAbZ.js';
+import { D as DevNotesCapabilities, a as DevNotesAppLinkStatus, c as DevNotesLinkAppInput } from './types-CrmObeqp.js';
+import { B as BugReport, i as BugReportCreateData, c as BugReportType, T as TaskList, j as BugReportMessage, d as BugReportCreator, h as AiConversationMessage, f as BugCaptureContext, g as AiAssistResult } from './types-DqIxvo5g.js';
 
 type DevNotesProxyRequest = {
     method: string;

package/dist/{router-CPtxoMg5.d.mts → router-DPFI-Ag4.d.mts}

@@ -1,4 +1,5 @@
-import { e as DevNotesCapabilities, f as DevNotesAppLinkStatus, n as DevNotesLinkAppInput, B as BugReport, l as BugReportCreateData, c as BugReportType, T as TaskList, m as BugReportMessage, d as BugReportCreator, k as AiConversationMessage, i as BugCaptureContext, j as AiAssistResult } from './types-xqGNcAbZ.mjs';
+import { D as DevNotesCapabilities, a as DevNotesAppLinkStatus, c as DevNotesLinkAppInput } from './types-CrmObeqp.mjs';
+import { B as BugReport, i as BugReportCreateData, c as BugReportType, T as TaskList, j as BugReportMessage, d as BugReportCreator, h as AiConversationMessage, f as BugCaptureContext, g as AiAssistResult } from './types-CBHExs2F.mjs';
 
 type DevNotesProxyRequest = {
     method: string;

package/dist/server/deno.d.mts

@@ -0,0 +1,5 @@
+import { d as DevNotesServerOptions } from '../types-CrmObeqp.mjs';
+
+declare function createDenoDevNotesHandler(options: DevNotesServerOptions): (request: Request) => Promise<Response>;
+
+export { createDenoDevNotesHandler };

package/dist/server/deno.d.ts

@@ -0,0 +1,5 @@
+import { d as DevNotesServerOptions } from '../types-CrmObeqp.js';
+
+declare function createDenoDevNotesHandler(options: DevNotesServerOptions): (request: Request) => Promise<Response>;
+
+export { createDenoDevNotesHandler };