qarpeo 0.0.0-alpha.10

package/dist/types.mjs

@@ -0,0 +1 @@
+

package/dist/utils/agents.d.ts

@@ -0,0 +1,8 @@
+import type { LayerLike } from "./drizzle.js";
+export interface DiscoveredAgent {
+    name: string;
+    file: string;
+    importPath: string;
+}
+/** Searches across all Nuxt layers for edge agent definition files inside `server/agents/`. */
+export declare function findAgentFiles(layers: readonly LayerLike[], dirName?: string): DiscoveredAgent[];

package/dist/utils/auth-schema.d.ts

@@ -0,0 +1,11 @@
+import type { AuthOptions } from "../types";
+export declare const ALL_AUTH_TABLE_NAMES: readonly ["_qarpeo_users", "_qarpeo_accounts", "_qarpeo_sessions", "_qarpeo_two_factor", "_qarpeo_authenticators", "_qarpeo_organizations", "_qarpeo_members", "_qarpeo_invitations", "_qarpeo_api_tokens"];
+/** Returns the list of active auth table names based on enabled feature flags in `auth`. */
+export declare function getActiveAuthTableNames(auth?: boolean | AuthOptions): string[];
+/**
+ * Dynamically composes Drizzle SQLite schema code based on active auth feature flags. Uses
+ * `snakeCase.table` from drizzle-orm/sqlite-core so camelCase property names are automatically
+ * mapped to snake_case column names — no manual column strings needed. Assembled at build time into
+ * `#qarpeo/auth/schema` and merged into `#qarpeo/schema`.
+ */
+export declare function generateAuthSchema(auth?: boolean | AuthOptions): string;

package/dist/utils/bindings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves a Cloudflare binding name with standard environment variable overrides.
+ *
+ * Precedence:
+ *
+ * 1. Explicit user override (from module options, e.g. `options.db.binding`)
+ * 2. `process.env.QARPEO_<SERVICE>_BINDING`
+ * 3. `process.env.<SERVICE>_BINDING`
+ * 4. Default fallback (e.g. "KV", "BLOB", "DB")
+ *
+ * @param service The canonical service key (e.g. "kv", "blob", "db", "cache", "ai", "vectorize",
+ *   "queue", "analytics", "ratelimit", "hyperdrive", "browser")
+ * @param override Explicit binding name override from options if provided
+ * @param defaultName Default binding name to use if not overridden or set in env
+ */
+export declare function resolveBindingName(service: string, override?: string, defaultName?: string): string;

package/dist/utils/cms-schema.d.ts

@@ -0,0 +1 @@
+export * from "../runtime/server/db/cms-schema";

package/dist/utils/cms-sources.d.ts

@@ -0,0 +1,62 @@
+import type { CMSSourceConfig, CMSResolvedSource, CMSCollectionConfig } from "../types";
+/**
+ * Tests whether an entry path matches one or more glob patterns. Supports:
+ *
+ * - Glob paths: `"/docs/**"`, `"/blog/*"`
+ * - Arrays: `["/docs/**", "/guides/**"]`
+ * - Negative excludes: `"!/docs/internal/**"`
+ */
+export declare function matchPathPatterns(entryPath: string, patterns?: string | string[]): boolean;
+/**
+ * Resolves which collection an entryPath belongs to, checking configured collections' `path`
+ * patterns first, then falling back to fallbackId.
+ */
+export declare function resolveCollectionForPath(entryPath: string, collectionsConfig?: Record<string, CMSCollectionConfig>, fallbackId?: string): string;
+/**
+ * Strips leading numeric ordering prefixes (e.g. "01.guide" -> "guide", "3.templates" ->
+ * "templates").
+ */
+export declare function stripOrderPrefix(name: string): string;
+/**
+ * Checks whether a path segment is a route group enclosed in parentheses. e.g. "(overview)" ->
+ * true, "1.(overview)" -> true, "01.(setup)" -> true, "guide" -> false
+ */
+export declare function isGroupSegment(segment: string): boolean;
+/**
+ * Extracts a clean human-readable title from a group segment. e.g. "(overview)" -> "Overview",
+ * "1.(quick-start)" -> "Quick Start", "02.(faq)" -> "FAQ"
+ */
+export declare function extractGroupTitle(segment: string): string;
+/**
+ * Extracts leading numeric ordering prefix as an integer (e.g. "01.guide" -> 1, "3.templates" ->
+ * 3).
+ */
+export declare function extractOrderPrefix(name: string): number | undefined;
+/** Checks whether a `from` specifier is a remote repository / URL. */
+export declare function isRemoteSource(from: string): boolean;
+/**
+ * Resolves the effective content URL prefix for a source. Follows Decision 29 filesystem
+ * conventions:
+ *
+ * - Omitted / './' : relative to the directory containing this _sources.yml
+ * - '../sub' : relative, up one level from this file
+ * - '/docs' : absolute from content root
+ */
+export declare function resolveSourcePrefix(writtenPrefix: string | undefined, fileDirRelToContent: string): string;
+/** Recursively scans contentDir for all .sources.json files. */
+export declare function discoverSources(contentDir: string): Promise<Array<{
+    filePath: string;
+    fileDirRel: string;
+    sources: CMSSourceConfig[];
+}>>;
+/**
+ * Resolves all discovered and config-declared sources into absolute disk paths and normalized
+ * prefixes. Downloads remote sources via giget tarball into the cache directory.
+ */
+export declare function resolveAllCmsSources(options: {
+    contentDir: string;
+    rootDir: string;
+    cacheDir: string;
+    configSources?: CMSSourceConfig[];
+}): Promise<CMSResolvedSource[]>;
+export { matchesSourceFilters, matchesGlobFilter } from "../runtime/server/utils/cms-filter";

package/dist/utils/drizzle.d.ts

@@ -0,0 +1,42 @@
+export interface SchemaExports {
+    /** Names exported as `export type Foo = ...` — erased at runtime, safe anywhere */
+    types: Array<{
+        name: string;
+        file: string;
+    }>;
+    /** Names exported as `export const fooSchema` (ends with "Schema") — Zod objects */
+    zod: Array<{
+        name: string;
+        file: string;
+    }>;
+}
+/**
+ * Scans schema source files with a lightweight regex pass to collect:
+ *
+ * - `export type <Name>` declarations → SchemaExports.types
+ * - `export const <name>Schema` declarations → SchemaExports.zod
+ */
+export declare function scanSchemaExports(schemaFiles: string[]): SchemaExports;
+export interface LayerLike {
+    cwd?: string;
+    config?: {
+        srcDir?: string;
+        rootDir?: string;
+    };
+}
+export interface DrizzleCheckResult {
+    installed: boolean;
+    version?: string;
+    isRC: boolean;
+    error?: string;
+}
+/**
+ * Detects whether drizzle-orm is installed and verifies that it is a v1.0.0 RC (drizzle-orm@rc) or
+ * newer.
+ */
+export declare function checkDrizzleVersion(rootDir: string): DrizzleCheckResult;
+/**
+ * Searches across all Nuxt layers for Drizzle database schema files. Checks server/db/schema.ts,
+ * server/db/schema/*.ts, server/database/schema.ts, etc.
+ */
+export declare function findSchemaFiles(layers: readonly LayerLike[]): string[];

package/dist/utils/jobs.d.ts

@@ -0,0 +1,8 @@
+import type { LayerLike } from "./drizzle.js";
+export interface DiscoveredJob {
+    name: string;
+    file: string;
+    importPath: string;
+}
+/** Searches across all Nuxt layers for background job files inside `server/jobs/`. */
+export declare function findJobFiles(layers: readonly LayerLike[], dirName?: string): DiscoveredJob[];

package/dist/utils/local-db.d.ts

@@ -0,0 +1,28 @@
+import { drizzle } from "drizzle-orm/node-sqlite";
+export interface LocalDatabaseContext {
+    sqlitePath: string;
+    schema: Record<string, any>;
+    db: ReturnType<typeof drizzle>;
+    customSeedPath: string | null;
+}
+/** Searches `.wrangler/state/v3/d1/miniflare-D1DatabaseObject/` for the local SQLite file. */
+export declare function findLocalD1Database(cwd: string): string | null;
+/** Dynamically resolves and creates a Jiti instance for executing TS files. */
+export declare function getJiti(cwd: string): Promise<any>;
+/** Loads the project schema and initializes a local Drizzle database instance connected to local D1. */
+export declare function getLocalDatabaseContext(cwd: string, nuxtConfig: any): Promise<LocalDatabaseContext>;
+export interface ApplyD1MigrationsOptions {
+    wranglerConfigPath?: string;
+    dbName?: string;
+    serverDir?: string;
+    remote?: boolean;
+    label?: string;
+}
+/**
+ * Automatically applies unapplied D1 database migrations.
+ * Safe to call on dev server startup or during build: checks if migration files exist,
+ * runs wrangler migrations apply, and handles non-interactive confirmation automatically.
+ */
+export declare function applyD1Migrations(cwd: string, options?: ApplyD1MigrationsOptions): boolean;
+/** Legacy alias for backward compatibility. */
+export declare const autoMigrateLocalD1: (cwd: string, options?: ApplyD1MigrationsOptions) => boolean;

package/dist/utils/notifications-schema.d.ts

@@ -0,0 +1,15 @@
+import type { NotificationsOptions } from "../types";
+export declare const ALL_NOTIFICATIONS_TABLE_NAMES: readonly ["_qarpeo_notifications", "_qarpeo_push_subscriptions"];
+export declare function getActiveNotificationsTableNames(notifications?: boolean | NotificationsOptions): string[];
+/**
+ * Generates the Drizzle ORM schema string for Qarpeo Notifications. Uses `snakeCase.table` from
+ * drizzle-orm/sqlite-core so camelCase property names automatically map to snake_case column
+ * names.
+ *
+ * Stores in-app notification records and Web Push subscriptions in Cloudflare D1.
+ */
+export declare function generateNotificationsSchema(notifications?: boolean | NotificationsOptions): string;
+/**
+ * Returns raw SQL DDL for table creation.
+ */
+export declare function generateNotificationsSql(options?: boolean | NotificationsOptions): string;

package/dist/utils/payments-schema.d.ts

@@ -0,0 +1,11 @@
+import type { PaymentsOptions } from "../types";
+export declare const ALL_PAYMENTS_TABLE_NAMES: readonly ["_qarpeo_customers", "_qarpeo_subscriptions", "_qarpeo_webhook_events", "_qarpeo_usage_records"];
+export declare function getActivePaymentsTableNames(payments?: boolean | PaymentsOptions): string[];
+/**
+ * Generates the Drizzle ORM schema string for Qarpeo Edge Payments. Uses `snakeCase.table` from
+ * drizzle-orm/sqlite-core so camelCase property names automatically map to snake_case column
+ * names.
+ *
+ * Stores customer records, subscription state, and metered usage records in Cloudflare D1.
+ */
+export declare function generatePaymentsSchema(payments?: boolean | PaymentsOptions): string;

package/dist/utils/pkg.d.ts

@@ -0,0 +1,15 @@
+/** Checks if a package is installed in the target project directory or bundled by qarpeo. */
+export declare function isPackageInstalled(packageName: string, cwd?: string): boolean;
+/** Checks if a binary exists in node_modules/.bin (in cwd, parent, or qarpeo tree). */
+export declare function resolveBinaryPath(binName: string, cwd?: string): string | null;
+/** Prompts the user interactively in the terminal to confirm package installation. */
+export declare function confirmInstall(packageName: string, purpose: string): Promise<boolean>;
+/**
+ * Ensures a required dependency is installed in the user's project. If missing, prompts the user to
+ * install it via their active package manager (pnpm/npm/yarn/bun).
+ */
+export declare function ensurePackage(packageName: string, options: {
+    cwd?: string;
+    dev?: boolean;
+    purpose: string;
+}): Promise<boolean>;

package/dist/utils/queue.d.ts

@@ -0,0 +1,8 @@
+import type { LayerLike } from "./drizzle.js";
+/**
+ * Searches across all Nuxt layers for queue consumer handler files:
+ *
+ * - Server/queue.ts
+ * - Server/queue/index.ts
+ */
+export declare function findQueueFiles(layers: readonly LayerLike[]): string[];

package/dist/utils/tenants-schema.d.ts

@@ -0,0 +1,11 @@
+import type { MultitenantOptions } from "../types";
+export declare const ALL_TENANTS_TABLE_NAMES: readonly ["_qarpeo_tenants", "_qarpeo_domains"];
+export declare function getActiveTenantsTableNames(multitenant?: boolean | MultitenantOptions): string[];
+/**
+ * Generates the Drizzle ORM schema string for Qarpeo Multi-Tenancy & Custom Domains. Uses
+ * `snakeCase.table` from drizzle-orm/sqlite-core so camelCase property names automatically map to
+ * snake_case column names.
+ *
+ * Stores tenant records and custom domain routing state in Cloudflare D1.
+ */
+export declare function generateTenantsSchema(multitenant?: boolean | MultitenantOptions): string;

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "qarpeo",
+  "version": "0.0.0-alpha.10",
+  "description": "Zero-config Cloudflare Edge Platform for Nuxt",
+  "keywords": [
+    "analytics-engine",
+    "cloudflare",
+    "cloudflare-workers",
+    "d1",
+    "drizzle",
+    "edge",
+    "hyperdrive",
+    "kv",
+    "nuxt",
+    "nuxt-module",
+    "queues",
+    "r2",
+    "vectorize",
+    "workers-ai"
+  ],
+  "homepage": "https://qarpeo.com",
+  "bugs": {
+    "url": "https://github.com/qarpeo/qarpeo/issues"
+  },
+  "license": "MIT",
+  "author": "Qarpeo <hello@qarpeo.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qarpeo/qarpeo.git"
+  },
+  "bin": {
+    "qarpeo": "dist/cli/index.mjs",
+    "qp": "dist/cli/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/module.mjs",
+  "types": "./dist/module.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.mjs"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cloudflare/puppeteer": "1.4.0",
+    "@comark/nuxt": "^0.8.1",
+    "@comark/vue": "^0.8.1",
+    "@nuxt/devtools-kit": "^4.1.0",
+    "@nuxt/kit": "npm:@nuxt/kit-nightly@^5.0.0-2611041456-7ae6258",
+    "@simplewebauthn/browser": "14.0.0",
+    "@simplewebauthn/server": "14.0.3",
+    "citty": "^0.2.2",
+    "comark": "^0.8.1",
+    "defu": "^6.1.7",
+    "drizzle-kit": "1.0.0-rc.5",
+    "drizzle-orm": "1.0.0-rc.5",
+    "drizzle-seed": "1.0.0-rc.5",
+    "giget": "^3.3.1",
+    "nuxt-auth-utils": "0.6.0",
+    "nypm": "^0.6.12",
+    "pathe": "^2.0.3",
+    "shiki": "^4.6.0",
+    "uqr": "0.1.3",
+    "wrangler": "^4.157.0",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@nuxt/schema": "npm:@nuxt/schema-nightly@5.0.0-2611041456-7ae6258",
+    "@types/node": "^26.6.6",
+    "@typescript/typescript6": "^6.0.2",
+    "h3": "^2.0.8",
+    "nitro": "3.0.261103-rc",
+    "nuxt": "npm:nuxt-nightly@^5.0.0-2611041456-7ae6258",
+    "typescript": "^7.0.2",
+    "unbuild": "^3.6.1",
+    "vite-plus": "1.5.0",
+    "vue": "^3.5.44",
+    "vue-sfc-transformer": "^0.3.1"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "version": "12.16.1",
+      "onFail": "download"
+    }
+  },
+  "scripts": {
+    "build": "unbuild && vpx tsc --emitDeclarationOnly --declaration --declarationMap false --outDir dist --project tsconfig.json",
+    "dev": "nuxt dev playground",
+    "dev:build": "nuxt build playground",
+    "dev:prepare": "nuxt prepare playground"
+  }
+}