@frigear-nu/subscriptions 0.1.2 → 0.2.0

package/dist/runtime/server/utils/subscriptions.js

@@ -1,22 +1,25 @@
 import { db, schema } from "@nuxthub/db";
 import { desc, eq } from "drizzle-orm";
+import { isoDate } from "@frigear-nu/module-kit/server";
 import { DEFAULT_ENTITLED_STATUSES, isEntitledRow } from "../../utils/plans.js";
+export function toSubscriptionDto(row) {
+  return {
+    id: row.id,
+    planKey: row.planKey,
+    priceId: row.priceId,
+    status: row.status,
+    cancelAtPeriodEnd: row.cancelAtPeriodEnd,
+    currentPeriodStart: isoDate(row.currentPeriodStart),
+    currentPeriodEnd: isoDate(row.currentPeriodEnd),
+    endedAt: isoDate(row.endedAt),
+    source: row.source === "manual" ? "manual" : "stripe"
+  };
+}
 export async function listUserSubscriptions(userId) {
   const rows = await db.select().from(schema.subscriptions).where(eq(schema.subscriptions.userId, userId)).orderBy(desc(schema.subscriptions.createdAt));
-  const iso = (date) => date ? date.toISOString() : null;
   const active = rows.filter((row) => isEntitledRow(row)).sort((a, b) => (b.currentPeriodEnd?.getTime() ?? 0) - (a.currentPeriodEnd?.getTime() ?? 0))[0];
   return {
-    subscriptions: rows.map((row) => ({
-      id: row.id,
-      planKey: row.planKey,
-      priceId: row.priceId,
-      status: row.status,
-      cancelAtPeriodEnd: row.cancelAtPeriodEnd,
-      currentPeriodStart: iso(row.currentPeriodStart),
-      currentPeriodEnd: iso(row.currentPeriodEnd),
-      endedAt: iso(row.endedAt),
-      source: row.source === "manual" ? "manual" : "stripe"
-    })),
+    subscriptions: rows.map(toSubscriptionDto),
     activePlan: active?.planKey ?? null
   };
 }

package/dist/runtime/utils/api.d.ts

@@ -0,0 +1,20 @@
+export declare const subscriptionsApi: {
+    /** `GET` the configured plans with live prices (public). */
+    readonly plans: "/api/subscriptions/plans";
+    readonly me: {
+        /** `GET` the caller's subscriptions and active plan (also the account bootstrap's `subscriptions:me`). */
+        readonly subscriptions: "/api/subscriptions/me";
+        /** `POST` to start a checkout or change plan (sessions only). */
+        readonly checkout: "/api/subscriptions/me/checkout";
+        /** `POST` to open the Stripe billing portal (sessions only). */
+        readonly portal: "/api/subscriptions/me/portal";
+    };
+    readonly admin: {
+        /** `GET` the user's current membership and grantable plans / `POST` a free grant / `DELETE` the free grant (staff). */
+        readonly membership: (userId: number | string) => string;
+        /** `GET` the user's whole subscription history (staff). */
+        readonly history: (userId: number | string) => string;
+        /** `POST` a Checkout link for the user, optionally emailed (staff). */
+        readonly paymentLink: (userId: number | string) => string;
+    };
+};

package/dist/runtime/utils/api.js

@@ -0,0 +1,23 @@
+const BASE = "/api/subscriptions";
+const enc = encodeURIComponent;
+const userBase = (userId) => `/api/admin/users/${enc(String(userId))}/membership`;
+export const subscriptionsApi = {
+  /** `GET` the configured plans with live prices (public). */
+  plans: `${BASE}/plans`,
+  me: {
+    /** `GET` the caller's subscriptions and active plan (also the account bootstrap's `subscriptions:me`). */
+    subscriptions: `${BASE}/me`,
+    /** `POST` to start a checkout or change plan (sessions only). */
+    checkout: `${BASE}/me/checkout`,
+    /** `POST` to open the Stripe billing portal (sessions only). */
+    portal: `${BASE}/me/portal`
+  },
+  admin: {
+    /** `GET` the user's current membership and grantable plans / `POST` a free grant / `DELETE` the free grant (staff). */
+    membership: userBase,
+    /** `GET` the user's whole subscription history (staff). */
+    history: (userId) => `${userBase(userId)}/history`,
+    /** `POST` a Checkout link for the user, optionally emailed (staff). */
+    paymentLink: (userId) => `${userBase(userId)}/payment-link`
+  }
+};

package/dist/runtime/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { getUserSubscription, hasActiveSubscription } from '../server/utils/subscriptions.js';
 export type { HasActiveSubscriptionOptions } from '../server/utils/subscriptions.js';
-export { decideChangeKind, resolvePlanKey, resolveSameOriginUrl, isWithinDisabledRanges, DEFAULT_ENTITLED_STATUSES } from './plans.js';
+export { decideChangeKind, resolvePlanKey, isWithinDisabledRanges, DEFAULT_ENTITLED_STATUSES } from './plans.js';
 export type { CheckoutBeforeContext, PlansFilterContext, ResolvedPlan, PlanPrice, SubscriptionDto, ModuleOptions, } from '../../types.js';
+export * from './api.js';

package/dist/runtime/utils/index.js

@@ -1,2 +1,3 @@
 export { getUserSubscription, hasActiveSubscription } from "../server/utils/subscriptions.js";
-export { decideChangeKind, resolvePlanKey, resolveSameOriginUrl, isWithinDisabledRanges, DEFAULT_ENTITLED_STATUSES } from "./plans.js";
+export { decideChangeKind, resolvePlanKey, isWithinDisabledRanges, DEFAULT_ENTITLED_STATUSES } from "./plans.js";
+export * from "./api.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frigear-nu/subscriptions",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Recurring subscriptions (plans, checkout, upgrade/downgrade, billing portal and entitlements) for the frigear ecosystem, built on @frigear-nu/stripe.",
   "homepage": "https://docs.frigear.dev/modules/subscriptions",
   "repository": {
@@ -21,6 +21,11 @@
       "types": "./dist/runtime/utils/index.d.ts",
       "import": "./dist/runtime/utils/index.js",
       "default": "./dist/runtime/utils/index.js"
+    },
+    "./api": {
+      "types": "./dist/runtime/utils/api.d.ts",
+      "import": "./dist/runtime/utils/api.js",
+      "default": "./dist/runtime/utils/api.js"
     }
   },
   "files": [
@@ -30,13 +35,13 @@
     "playground"
   ],
   "dependencies": {
-    "@frigear-nu/auth": "0.1.3",
-    "@frigear-nu/mcp": "0.1.2",
-    "@frigear-nu/module-kit": "1.1.2",
-    "@frigear-nu/notify": "0.1.2",
-    "@frigear-nu/stripe": "0.1.2",
-    "@frigear-nu/ui": "0.1.2",
-    "@frigear-nu/users": "1.1.3",
+    "@frigear-nu/auth": "0.2.0",
+    "@frigear-nu/mcp": "0.2.0",
+    "@frigear-nu/module-kit": "1.2.0",
+    "@frigear-nu/notify": "0.2.0",
+    "@frigear-nu/stripe": "0.2.0",
+    "@frigear-nu/ui": "0.2.0",
+    "@frigear-nu/users": "1.2.0",
     "@libsql/client": "^0.18.0",
     "@nuxt/kit": "^4.6.1",
     "@vueuse/core": "^15.0.0",
@@ -49,8 +54,8 @@
   },
   "peerDependencies": {
     "@frigear-nu/email-templates": "0.1.0",
-    "@frigear-nu/menu": "0.1.2",
-    "@frigear-nu/widget": "0.1.2",
+    "@frigear-nu/menu": "0.2.0",
+    "@frigear-nu/widget": "0.2.0",
     "@nuxt/ui": "^4.12.0",
     "@nuxthub/core": "^0.10.8"
   },
@@ -70,8 +75,8 @@
   },
   "devDependencies": {
     "@frigear-nu/email-templates": "0.1.0",
-    "@frigear-nu/menu": "0.1.2",
-    "@frigear-nu/widget": "0.1.2",
+    "@frigear-nu/menu": "0.2.0",
+    "@frigear-nu/widget": "0.2.0",
     "@nuxt/devtools": "^3.4.2",
     "@nuxt/eslint-config": "^1.17.0",
     "@nuxt/module-builder": "^1.0.3",