qarpeo 0.0.0-alpha.10

package/dist/runtime/app/pages/devtools.vue

@@ -0,0 +1,165 @@
+<script setup lang="ts">
+import { computed } from "vue"
+
+definePageMeta({ layout: false })
+
+const route = useRoute()
+
+const { data: settingsData } = useFetch<any>("/_qarpeo/api/settings", {
+  default: () => null,
+})
+
+// DevTools dock base path
+const basePath = computed(() => "/_qarpeo/devtools")
+
+// ─── Navigation with Module Activation Guards ────────────────────────────────
+const allNavItems = computed(() => [
+  {
+    id: "overview",
+    label: "Overview",
+    icon: "i-lucide-layout-dashboard",
+    to: `${basePath.value}/overview`,
+    always: true,
+  },
+  {
+    id: "auth",
+    label: "Auth & Users",
+    icon: "i-lucide-users",
+    to: `${basePath.value}/auth`,
+    moduleKey: "auth",
+  },
+  {
+    id: "db",
+    label: "Database (D1)",
+    icon: "i-lucide-database",
+    to: `${basePath.value}/db`,
+    moduleKey: "db",
+  },
+  {
+    id: "kv",
+    label: "KV Store",
+    icon: "i-lucide-zap",
+    to: `${basePath.value}/kv`,
+    moduleKey: "kv",
+  },
+  {
+    id: "blob",
+    label: "Blob Storage",
+    icon: "i-lucide-box",
+    to: `${basePath.value}/blob`,
+    moduleKey: "blob",
+  },
+  {
+    id: "domains",
+    label: "Domains & Tenants",
+    icon: "i-lucide-globe",
+    to: `${basePath.value}/domains`,
+    moduleKey: "multitenant",
+  },
+  {
+    id: "analytics",
+    label: "Analytics",
+    icon: "i-lucide-bar-chart-3",
+    to: `${basePath.value}/analytics`,
+    moduleKey: "analytics",
+  },
+  {
+    id: "mail",
+    label: "Dev Mailbox",
+    icon: "i-lucide-mail",
+    to: `${basePath.value}/mail`,
+    moduleKey: "mail",
+  },
+  {
+    id: "agents",
+    label: "Edge Agents",
+    icon: "i-lucide-bot",
+    to: `${basePath.value}/agents`,
+    moduleKey: "agents",
+  },
+  {
+    id: "logs",
+    label: "Tail Logs",
+    icon: "i-lucide-terminal",
+    to: `${basePath.value}/logs`,
+    always: true,
+  },
+  {
+    id: "settings",
+    label: "Settings & Config",
+    icon: "i-lucide-settings",
+    to: `${basePath.value}/settings`,
+    always: true,
+  },
+])
+
+const navItems = computed(() => allNavItems.value)
+
+const navMenuItems = computed(() =>
+  navItems.value.map((item) => ({
+    label: item.label,
+    icon: item.icon,
+    to: item.to,
+    badge: (item as any).badge,
+  })),
+)
+</script>
+
+<template>
+  <UDashboardGroup>
+    <!-- ── Left Dashboard Sidebar ────────────────────────────────────── -->
+    <UDashboardSidebar
+      resizable
+      collapsible
+      :ui="{ header: 'border-b border-default', footer: 'border-t border-default' }"
+    >
+      <template #header="{ collapsed }">
+        <div class="flex items-center gap-2.5 px-3 py-2 w-full overflow-hidden">
+          <div
+            class="w-7 h-7 rounded-lg bg-primary/10 border border-primary/20 flex items-center justify-center text-primary shrink-0"
+          >
+            <UIcon name="i-lucide-layers" class="w-4 h-4" />
+          </div>
+          <div v-if="!collapsed" class="flex items-center gap-2 truncate">
+            <span class="font-bold text-sm tracking-tight text-highlighted">Qarpeo</span>
+            <UBadge color="primary" variant="subtle" size="xs">DevTools</UBadge>
+          </div>
+        </div>
+      </template>
+
+      <!-- Navigation items -->
+      <UNavigationMenu
+        :items="navMenuItems"
+        orientation="vertical"
+        highlight
+        highlight-color="primary"
+        color="neutral"
+      />
+
+      <template #footer="{ collapsed }">
+        <div class="p-3 space-y-2">
+          <div v-if="!collapsed" class="flex items-center justify-between text-[11px] text-muted">
+            <span class="flex items-center gap-1.5">
+              <span class="w-2 h-2 rounded-full bg-success"></span>
+              Development
+            </span>
+            <span class="font-mono text-[10px] bg-muted px-1.5 py-0.5 rounded text-muted"
+              >Alt + Q</span
+            >
+          </div>
+          <UButton
+            to="/cms"
+            label="Open CMS"
+            icon="i-lucide-file-text"
+            size="xs"
+            color="neutral"
+            variant="outline"
+            class="w-full justify-center text-xs"
+          />
+        </div>
+      </template>
+    </UDashboardSidebar>
+
+    <NuxtPage />
+  </UDashboardGroup>
+</template>

package/dist/runtime/app/plugins/seo.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/runtime/app/plugins/seo.mjs

@@ -0,0 +1,105 @@
+import { computed } from "vue";
+import { defineNuxtPlugin, useHead, useRoute, useRuntimeConfig, useSeoMeta } from "#imports";
+export default defineNuxtPlugin(() => {
+  const runtimeConfig = useRuntimeConfig();
+  const site = runtimeConfig.public?.qarpeo?.site || {};
+  if (!site || !site.name && !site.url && !site.description) {
+    return;
+  }
+  const siteName = site.name || "App";
+  const separator = site.separator || "\u2014";
+  const rawTemplate = site.titleTemplate || `%s ${separator} %siteName`;
+  useHead({
+    htmlAttrs: {
+      lang: site.defaultLocale || "en"
+    },
+    titleTemplate: (titleChunk) => {
+      if (!titleChunk) return siteName;
+      return rawTemplate.replace(/%s/g, titleChunk).replace(/%siteName/g, siteName);
+    }
+  });
+  const baseSeo = {
+    ogSiteName: siteName,
+    ogLocale: site.defaultLocale || "en",
+    twitterCard: "summary_large_image"
+  };
+  if (site.name) {
+    baseSeo.title = site.name;
+    baseSeo.ogTitle = site.name;
+  }
+  if (site.description) {
+    baseSeo.description = site.description;
+    baseSeo.ogDescription = site.description;
+    baseSeo.twitterDescription = site.description;
+  }
+  if (site.image) {
+    const imageUrl = site.image.startsWith("http") ? site.image : site.url ? `${site.url.replace(/\/$/, "")}/${site.image.replace(/^\//, "")}` : site.image;
+    baseSeo.ogImage = imageUrl;
+    baseSeo.twitterImage = imageUrl;
+  }
+  if (site.twitter) {
+    baseSeo.twitterSite = site.twitter;
+    baseSeo.twitterCreator = site.twitter;
+  }
+  if (typeof site.robots === "object" && site.robots.index === false) {
+    baseSeo.robots = "noindex, nofollow";
+  } else if (site.robots === false) {
+    baseSeo.robots = "noindex, nofollow";
+  }
+  useSeoMeta(baseSeo);
+  if (site.url) {
+    const route = useRoute();
+    const baseUrl = site.url.replace(/\/$/, "");
+    const canonicalHref = computed(() => {
+      const cleanPath = route.path === "/" ? "" : route.path;
+      return `${baseUrl}${cleanPath}`;
+    });
+    useHead({
+      link: computed(() => {
+        const links = [
+          {
+            rel: "canonical",
+            href: canonicalHref.value
+          }
+        ];
+        if (site.feed !== false) {
+          links.push({
+            rel: "alternate",
+            type: "application/rss+xml",
+            title: siteName,
+            href: `${baseUrl}/feed.xml`
+          });
+          links.push({
+            rel: "alternate",
+            type: "application/atom+xml",
+            title: `${siteName} (Atom)`,
+            href: `${baseUrl}/atom.xml`
+          });
+        }
+        return links;
+      })
+    });
+    useSeoMeta({
+      ogUrl: canonicalHref
+    });
+    if (site.schemaOrg !== false) {
+      useHead({
+        script: computed(() => {
+          if (route.path !== "/") return [];
+          return [
+            {
+              type: "application/ld+json",
+              innerHTML: JSON.stringify({
+                "@context": "https://schema.org",
+                "@type": "WebSite",
+                name: siteName,
+                url: baseUrl,
+                description: site.description || void 0
+              })
+            }
+          ];
+        })
+      });
+    }
+  }
+});

package/dist/runtime/app/plugins/shortcuts.client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Qarpeo keyboard shortcuts plugin. Alt+Q -> Open /_qarpeo/devtools (Qarpeo DevTools) Alt+C ->
+ * Navigate to /cms (CMS)
+ */
+declare const _default: any;
+export default _default;

package/dist/runtime/app/plugins/shortcuts.client.mjs

@@ -0,0 +1,19 @@
+import { defineNuxtPlugin, useRouter } from "#imports";
+export default defineNuxtPlugin(() => {
+  if (import.meta.server) return;
+  const router = useRouter();
+  window.addEventListener("keydown", (e) => {
+    const target = e.target;
+    if (target && (target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable)) {
+      return;
+    }
+    if (e.altKey && !e.ctrlKey && !e.metaKey && (e.key === "q" || e.key === "Q")) {
+      e.preventDefault();
+      window.open("/_qarpeo/devtools", "_blank");
+    }
+    if (e.altKey && !e.ctrlKey && !e.metaKey && (e.key === "c" || e.key === "C")) {
+      e.preventDefault();
+      router.push("/cms");
+    }
+  });
+});

package/dist/runtime/app/public/sw-notifications.mjs

@@ -0,0 +1,52 @@
+/**
+ * Qarpeo Notifications Service Worker
+ * Handles Web Push events and shows browser notifications.
+ */
+
+self.addEventListener("push", (event) => {
+  if (!event.data) return
+
+  let payload
+  try {
+    payload = event.data.json()
+  } catch {
+    payload = { title: "New notification", body: event.data.text() }
+  }
+
+  const title = payload.title || "Notification"
+  const options = {
+    body: payload.body || "",
+    icon: payload.icon || "/icon.png",
+    badge: "/badge.png",
+    data: payload.data || {},
+    requireInteraction: false,
+  }
+
+  event.waitUntil(self.registration.showNotification(title, options))
+})
+
+self.addEventListener("notificationclick", (event) => {
+  event.notification.close()
+
+  const actionUrl = event.notification.data?.actionUrl
+
+  if (actionUrl) {
+    event.waitUntil(
+      clients
+        .matchAll({ type: "window", includeUncontrolled: true })
+        .then((windowClients) => {
+          for (const client of windowClients) {
+            if (client.url === actionUrl && "focus" in client) {
+              return client.focus()
+            }
+          }
+          if (clients.openWindow) {
+            return clients.openWindow(actionUrl)
+          }
+        }),
+    )
+  }
+})
+
+self.addEventListener("install", () => self.skipWaiting())
+self.addEventListener("activate", (event) => event.waitUntil(clients.claim()))

package/dist/runtime/auth.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Standard auth user columns mixin for Tier 3 custom schema declarations.
+ *
+ * @example
+ *   ;```ts
+ *   import { sqliteTable, text } from "drizzle-orm/sqlite-core"
+ *   import { authUserFields } from "qarpeo/auth"
+ *
+ *   export const users = sqliteTable("users", {
+ *     ...authUserFields,
+ *     bio: text("bio"),
+ *     customField: text("custom_field"),
+ *   })
+ *   ```
+ */
+export declare const authUserFields: {
+    id: import("drizzle-orm").IsPrimaryKey<import("drizzle-orm/sqlite-core").SQLiteTextBuilder<[string, ...string[]]>>;
+    email: import("drizzle-orm").NotNull<import("drizzle-orm/sqlite-core").SQLiteTextBuilder<[string, ...string[]]>>;
+    emailVerified: import("drizzle-orm").HasDefault<import("drizzle-orm/sqlite-core").SQLiteIntegerBuilder>;
+    name: import("drizzle-orm/sqlite-core").SQLiteTextBuilder<[string, ...string[]]>;
+    avatarUrl: import("drizzle-orm/sqlite-core").SQLiteTextBuilder<[string, ...string[]]>;
+    role: import("drizzle-orm").HasDefault<import("drizzle-orm/sqlite-core").SQLiteTextBuilder<[string, ...string[]]>>;
+    createdAt: import("drizzle-orm").NotNull<import("drizzle-orm/sqlite-core").SQLiteIntegerBuilder>;
+    updatedAt: import("drizzle-orm").NotNull<import("drizzle-orm/sqlite-core").SQLiteIntegerBuilder>;
+};

package/dist/runtime/auth.mjs

@@ -0,0 +1,11 @@
+import { text, integer } from "drizzle-orm/sqlite-core";
+export const authUserFields = {
+  id: text("id").primaryKey(),
+  email: text("email").notNull().unique(),
+  emailVerified: integer("email_verified").default(0),
+  name: text("name"),
+  avatarUrl: text("avatar_url"),
+  role: text("role").default("user"),
+  createdAt: integer("created_at").notNull(),
+  updatedAt: integer("updated_at").notNull()
+};

package/dist/runtime/bindings.d.ts

@@ -0,0 +1,27 @@
+import type { CFEvent } from "./types";
+/**
+ * Returns the active Cloudflare environment bindings for the current context. Resolves across 7
+ * execution tiers:
+ *
+ * 1. Event context: event.context.cloudflare.env (Nitro/H3, modern Nuxt RequestEvent)
+ * 2. Event context: event.env (Hono, SvelteKit platform.env)
+ * 3. Cached Cloudflare env from request plugin
+ * 4. Nitro 3 event.req.runtime.cloudflare.env
+ * 5. Dev proxy cache (**QARPEO_DEV_ENV**)
+ * 6. Cloudflare workerd globals (**env**, env)
+ * 7. Process env fallback
+ */
+export declare function getCloudflareEnv(event?: CFEvent): Record<string, any>;
+/**
+ * Manually set or override the active Cloudflare environment. Useful in custom middleware or
+ * testing setups.
+ */
+export declare function setCloudflareEnv(env: Record<string, any>): void;
+/**
+ * Resolves a runtime binding name with standard environment variable fallbacks.
+ *
+ * @param service Service name (e.g. "kv", "blob", "db", "analytics", etc.)
+ * @param override Explicit binding override from the caller
+ * @param defaultName Default binding name fallback
+ */
+export declare function resolveRuntimeBinding(service: string, override?: string, defaultName?: string): string;

package/dist/runtime/bindings.mjs

@@ -0,0 +1,38 @@
+export function getCloudflareEnv(event) {
+  const evt = event || globalThis.__qarpeo_event__;
+  if (evt?.context?.cloudflare?.env) {
+    return evt.context.cloudflare.env;
+  }
+  if (evt?.env) {
+    return evt.env;
+  }
+  if (evt?.platform?.env) {
+    return evt.platform.env;
+  }
+  if (globalThis.__qarpeo_env__) {
+    return globalThis.__qarpeo_env__;
+  }
+  if (evt?.req?.runtime?.cloudflare?.env) {
+    return evt.req.runtime.cloudflare.env;
+  }
+  if (globalThis.__QARPEO_DEV_ENV__) {
+    return globalThis.__QARPEO_DEV_ENV__;
+  }
+  if (globalThis.__env__) {
+    return globalThis.__env__;
+  }
+  if (globalThis.env) {
+    return globalThis.env;
+  }
+  return globalThis.process?.env || {};
+}
+export function setCloudflareEnv(env) {
+  ;
+  globalThis.__qarpeo_env__ = env;
+}
+export function resolveRuntimeBinding(service, override, defaultName) {
+  if (override) return override;
+  const upper = service.toUpperCase();
+  const procEnv = globalThis.process?.env;
+  return procEnv?.[`QARPEO_DEFAULT_${upper}_BINDING`] || procEnv?.[`QARPEO_${upper}_BINDING`] || procEnv?.[`${upper}_BINDING`] || defaultName || upper;
+}

package/dist/runtime/blob.d.ts

@@ -0,0 +1,26 @@
+import type { CFEvent } from "./types/index";
+import type { QarpeoBlob, R2Bucket, BlobEnsureOptions } from "./types/r2";
+/** Returns the raw Cloudflare R2Bucket binding from the active environment. */
+export declare function getR2Binding(bindingName?: string, event?: CFEvent): R2Bucket;
+/** Parses size strings like '2MB', '500KB', '1GB' into integer bytes. */
+export declare function parseByteSize(size: string | number): number;
+/**
+ * Validates a file against size and MIME type constraints. Throws HTTP 413 (Payload Too Large) or
+ * 415 (Unsupported Media Type).
+ */
+export declare function ensureBlob(file: {
+    size?: number;
+    type?: string;
+    name?: string;
+}, options: BlobEnsureOptions): void;
+/** Creates a typed Blob/R2 interface for a specific binding and optional event. */
+export declare function createBlob(bindingName?: string, event?: CFEvent): QarpeoBlob;
+/**
+ * Access a typed Cloudflare R2 Blob instance.
+ *
+ * @param bindingName Optional R2 binding name (defaults to configured binding or 'BLOB')
+ * @param event Optional event context
+ */
+export declare const useBlob: (bindingName?: string, event?: CFEvent) => QarpeoBlob;
+/** Auto-imported `blob` instance for direct Cloudflare R2 Blob operations. */
+export declare const blob: QarpeoBlob;