@windrun-huaiin/backend-core 30.0.0 → 31.0.1

package/README.md

@@ -0,0 +1,95 @@
+# @windrun-huaiin/backend-core
+
+Shared backend primitives for Next.js applications, including Prisma access, database services, authentication helpers, Stripe integration, credit and pricing server utilities, Upstash utilities, AI services, and ready-to-wire API route handlers.
+
+This package is organized around public subpath exports. Import the narrowest entry point that matches the backend capability you need, especially when separating server-only code from route handlers.
+
+## Feature Areas
+
+### Core Backend Utilities
+
+The root entry provides shared backend exports for application code that needs the common backend surface of the package.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core` | Shared backend primitives and common exports |
+
+### Prisma and Database Services
+
+The Prisma and database entries provide the data-access layer for applications that share database models, service methods, and transaction-oriented backend logic.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/prisma` | Prisma client and Prisma-related utilities |
+| `@windrun-huaiin/backend-core/database` | Database service layer |
+| `@windrun-huaiin/backend-core/aggregate` | Aggregate service layer |
+| `@windrun-huaiin/backend-core/context` | Backend context helpers |
+
+### Authentication
+
+Authentication entries provide shared server utilities, shared auth definitions, and middleware helpers for applications that need consistent auth handling.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/auth/server` | Server-side authentication helpers |
+| `@windrun-huaiin/backend-core/auth/shared` | Shared authentication utilities and definitions |
+| `@windrun-huaiin/backend-core/auth/middleware` | Authentication middleware helpers |
+
+### Stripe, Pricing, and Credits
+
+Commerce entries cover Stripe integration, checkout and customer portal route handlers, pricing server helpers, and credit server helpers.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/stripe` | Stripe service layer |
+| `@windrun-huaiin/backend-core/stripe/server` | Server-side Stripe configuration helpers |
+| `@windrun-huaiin/backend-core/pricing/server` | Server-side pricing helpers |
+| `@windrun-huaiin/backend-core/credit/server` | Server-side credit helpers |
+| `@windrun-huaiin/backend-core/config/money-price` | Money-price configuration |
+| `@windrun-huaiin/backend-core/app/api/stripe/checkout/route` | Stripe checkout API route handler |
+| `@windrun-huaiin/backend-core/app/api/stripe/customer-portal/route` | Stripe customer portal API route handler |
+| `@windrun-huaiin/backend-core/app/api/webhook/stripe/route` | Stripe webhook API route handler |
+
+### User and Clerk Routes
+
+User route handlers provide reusable API endpoints for anonymous user initialization, credit overview, pricing context, and Clerk user webhooks.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/app/api/user/anonymous/init/route` | Anonymous user initialization API route handler |
+| `@windrun-huaiin/backend-core/app/api/user/credit-overview/route` | User credit overview API route handler |
+| `@windrun-huaiin/backend-core/app/api/user/pricing-context/route` | User pricing context API route handler |
+| `@windrun-huaiin/backend-core/app/api/webhook/clerk/user/route` | Clerk user webhook API route handler |
+
+### Fingerprint and Upstash
+
+Fingerprint and Upstash entries expose server-side configuration and infrastructure helpers for identity and storage-related backend workflows.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/config/fingerprint` | Fingerprint configuration |
+| `@windrun-huaiin/backend-core/upstash/server` | Server-side Upstash helpers |
+
+### AI Services
+
+AI entries provide shared AI service utilities and a reusable API route handler for AI endpoints.
+
+| Entry | Purpose |
+| --- | --- |
+| `@windrun-huaiin/backend-core/ai` | AI service layer |
+| `@windrun-huaiin/backend-core/app/api/ai/route` | AI API route handler |
+
+## Usage Notes
+
+- Use server-only entries from server components, route handlers, server actions, or backend modules.
+- Use API route handler entries when an application wants to mount the package-provided route behavior directly in a Next.js route.
+- Keep Prisma, database, Stripe, auth, and Upstash imports out of client-side code.
+- Prefer feature-specific subpath imports so each application depends only on the backend capabilities it actually uses.
+
+## Installation
+
+```bash
+pnpm add @windrun-huaiin/backend-core
+```
+
+This package is intended for Next.js backend usage. The consuming application is responsible for its environment variables, database setup, authentication provider setup, Stripe setup, and deployment configuration.

package/dist/app/api/user/anonymous/init/fingerprint-only-route.d.ts

@@ -0,0 +1,8 @@
+import type { NextRequest } from 'next/server';
+/**
+ * Fingerprint-only anonymous user initialization API.
+ * Use this route in apps that do not install or configure Clerk.
+ * POST /api/user/anonymous/init
+ */
+export declare function POST(request: NextRequest): Promise<import("next/server").NextResponse<unknown>>;
+//# sourceMappingURL=fingerprint-only-route.d.ts.map

package/dist/app/api/user/anonymous/init/fingerprint-only-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-only-route.d.ts","sourceRoot":"","sources":["../../../../../../src/app/api/user/anonymous/init/fingerprint-only-route.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,wDAK9C"}

package/dist/app/api/user/anonymous/init/fingerprint-only-route.js

@@ -0,0 +1,20 @@
+'use strict';
+
+var tslib = require('tslib');
+var routeShared = require('./route-shared.js');
+
+/**
+ * Fingerprint-only anonymous user initialization API.
+ * Use this route in apps that do not install or configure Clerk.
+ * POST /api/user/anonymous/init
+ */
+function POST(request) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        return routeShared.handleFingerprintRequest(request, {
+            createIfNotExists: true,
+            getAuthIdentity: () => tslib.__awaiter(this, void 0, void 0, function* () { return null; }),
+        });
+    });
+}
+
+exports.POST = POST;

package/dist/app/api/user/anonymous/init/fingerprint-only-route.mjs

@@ -0,0 +1,18 @@
+import { __awaiter } from 'tslib';
+import { handleFingerprintRequest } from './route-shared.mjs';
+
+/**
+ * Fingerprint-only anonymous user initialization API.
+ * Use this route in apps that do not install or configure Clerk.
+ * POST /api/user/anonymous/init
+ */
+function POST(request) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return handleFingerprintRequest(request, {
+            createIfNotExists: true,
+            getAuthIdentity: () => __awaiter(this, void 0, void 0, function* () { return null; }),
+        });
+    });
+}
+
+export { POST };

package/dist/app/api/user/anonymous/init/route-shared.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderIdentity } from '@core/auth/auth-shared';
+import { NextRequest, NextResponse } from 'next/server';
+/**
+ * Shared fingerprint request handling logic.
+ */
+export declare function handleFingerprintRequest(request: NextRequest, options: {
+    createIfNotExists?: boolean;
+    getAuthIdentity: () => Promise<ProviderIdentity | null>;
+}): Promise<NextResponse<unknown>>;
+//# sourceMappingURL=route-shared.d.ts.map

package/dist/app/api/user/anonymous/init/route-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-shared.d.ts","sourceRoot":"","sources":["../../../../../../src/app/api/user/anonymous/init/route-shared.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAknBxD;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACzD,kCAkEA"}