@nebutra/license 0.1.3 → 2.0.0

package/README.md

@@ -1,5 +1,8 @@
 # @nebutra/license
 
+Status: **Foundation** — the issuance and validation contract is usable; the
+database surface is host-injected and delivery needs an email provider.
+
 > License domain logic for issuance, validation, and lifecycle event handling.
 
 ## Installation

package/dist/db.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Host-injected system DB surface for license operations.
+ * This package never imports private `@nebutra/db`.
+ */
+export interface LicenseRecord {
+    id: string;
+    licenseKey: string;
+    userId: string;
+    tier: string;
+    type: string;
+    expiresAt: Date | null;
+}
+export interface LicenseDb {
+    license: {
+        findFirst(args: {
+            where: Record<string, unknown>;
+            select?: Record<string, boolean>;
+        }): Promise<LicenseRecord | null>;
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<LicenseRecord>;
+    };
+    sleptonsaMemberProfile: {
+        findUnique(args: {
+            where: {
+                user_id: string;
+            };
+        }): Promise<{
+            id: string;
+        } | null>;
+        create(args: {
+            data: Record<string, unknown>;
+        }): Promise<{
+            id: string;
+            member_number: number;
+        }>;
+        update(args: {
+            where: {
+                id: string;
+            };
+            data: Record<string, unknown>;
+        }): Promise<unknown>;
+    };
+}
+/**
+ * Wire host-owned Prisma (e.g. `getSystemDb` from the app data layer).
+ */
+export declare function configureLicenseSystemDb(getSystemDb: () => unknown): void;
+/** @internal — tests */
+export declare function __resetLicenseSystemDbForTests(): void;
+export declare function requireLicenseDb(): LicenseDb;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE;QACP,SAAS,CAAC,IAAI,EAAE;YACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAClC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;KACzE,CAAC;IACF,sBAAsB,EAAE;QACtB,UAAU,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;QACjF,MAAM,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChG,MAAM,CAAC,IAAI,EAAE;YAAE,KAAK,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC1F,CAAC;CACH;AAID;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,OAAO,GAAG,IAAI,CAEzE;AAED,wBAAwB;AACxB,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAED,wBAAgB,gBAAgB,IAAI,SAAS,CAO5C"}

package/dist/db.js

@@ -0,0 +1,21 @@
+/**
+ * Host-injected system DB surface for license operations.
+ * This package never imports private `@nebutra/db`.
+ */
+let getter;
+/**
+ * Wire host-owned Prisma (e.g. `getSystemDb` from the app data layer).
+ */
+export function configureLicenseSystemDb(getSystemDb) {
+    getter = () => getSystemDb();
+}
+/** @internal — tests */
+export function __resetLicenseSystemDbForTests() {
+    getter = undefined;
+}
+export function requireLicenseDb() {
+    if (!getter) {
+        throw new Error("@nebutra/license requires a host DB client. Call configureLicenseSystemDb(getSystemDb) at app bootstrap.");
+    }
+    return getter();
+}

package/dist/handlers/on-license-issued.d.ts

@@ -8,6 +8,8 @@ import type { LicenseIssuedEvent } from "../types";
  *
  * Designed to be registered with `@nebutra/queue`:
  *   queue.registerHandler("license", "issued", onLicenseIssued)
+ *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
  */
 export declare function onLicenseIssued(job: {
     data: LicenseIssuedEvent;

package/dist/handlers/on-license-issued.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on-license-issued.d.ts","sourceRoot":"","sources":["../../src/handlers/on-license-issued.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DtF"}
+{"version":3,"file":"on-license-issued.d.ts","sourceRoot":"","sources":["../../src/handlers/on-license-issued.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DtF"}

package/dist/handlers/on-license-issued.js

@@ -1,6 +1,6 @@
-import { getSystemDb } from "@nebutra/db";
 import { sendLicenseCreatedEmail } from "@nebutra/email";
 import { logger } from "@nebutra/logger";
+import { requireLicenseDb } from "../db";
 import { generateSlug } from "../generate-slug";
 const log = logger.child({ service: "license:on-issued" });
 /**
@@ -12,12 +12,14 @@ const log = logger.child({ service: "license:on-issued" });
  *
  * Designed to be registered with `@nebutra/queue`:
  *   queue.registerHandler("license", "issued", onLicenseIssued)
+ *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
  */
 export async function onLicenseIssued(job) {
     const { licenseId, licenseKey, userId, tier, displayName, email, avatarUrl, lookingFor, githubHandle, } = job.data;
     // AUDIT(no-tenant): Sleptons member profiles are keyed on user_id and
     // are not per-tenant — they belong to the global community namespace.
-    const db = getSystemDb();
+    const db = requireLicenseDb();
     // 1. Create Sleptons member profile
     const existingProfile = await db.sleptonsaMemberProfile.findUnique({
         where: { user_id: userId },

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { configureLicenseSystemDb, type LicenseDb, type LicenseRecord, } from "./db";
 export { generateSlug } from "./generate-slug";
 export { issueLicense } from "./issue-license";
 export type { IssueLicenseParams, IssueLicenseResult, LicenseIssuedEvent, LicenseTier, LicenseType, ValidateLicenseResult, } from "./types";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { configureLicenseSystemDb, } from "./db";
 export { generateSlug } from "./generate-slug";
 export { issueLicense } from "./issue-license";
 export { LicenseTierSchema, LicenseTypeSchema } from "./types";

package/dist/issue-license.d.ts

@@ -7,6 +7,8 @@ import type { IssueLicenseParams, IssueLicenseResult } from "./types";
  * - Enqueues a `license.issued` event for downstream handlers
  *   (member profile creation, welcome email, etc.)
  * - Idempotent: returns existing license if user+tier already exists
+ *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
  */
 export declare function issueLicense(params: IssueLicenseParams): Promise<IssueLicenseResult>;
 //# sourceMappingURL=issue-license.d.ts.map

package/dist/issue-license.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-license.d.ts","sourceRoot":"","sources":["../src/issue-license.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAGnB,MAAM,SAAS,CAAC;AAUjB;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkE1F"}
+{"version":3,"file":"issue-license.d.ts","sourceRoot":"","sources":["../src/issue-license.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAGnB,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkE1F"}

package/dist/issue-license.js

@@ -1,6 +1,6 @@
-import { getSystemDb } from "@nebutra/db";
 import { logger } from "@nebutra/logger";
 import { createJob, getQueue } from "@nebutra/queue";
+import { requireLicenseDb } from "./db";
 const log = logger.child({ service: "license" });
 const ONE_YEAR_MS = 365 * 24 * 60 * 60 * 1000;
 function resolveLicenseType(tier) {
@@ -14,12 +14,14 @@ function resolveLicenseType(tier) {
  * - Enqueues a `license.issued` event for downstream handlers
  *   (member profile creation, welcome email, etc.)
  * - Idempotent: returns existing license if user+tier already exists
+ *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
  */
 export async function issueLicense(params) {
     const { userId, tier } = params;
     // AUDIT(no-tenant): licenses are user-scoped (not tenant-scoped); they pre-
     // date any Organization membership and are queried by userId/licenseKey.
-    const db = getSystemDb();
+    const db = requireLicenseDb();
     // Idempotency: check for existing license
     const existing = await db.license.findFirst({
         where: { userId, tier },

package/dist/validate-license.d.ts

@@ -6,6 +6,8 @@ import type { ValidateLicenseResult } from "./types";
  * Used by the CLI `nebutra license activate` and the public
  * `/api/license/validate` endpoint.
  *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
+ *
  * AUDIT(no-tenant): licenses are keyed on userId and are not scoped to any
  * Organization; the validate flow runs pre-auth against a global key space.
  */

package/dist/validate-license.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-license.d.ts","sourceRoot":"","sources":["../src/validate-license.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoBjF"}
+{"version":3,"file":"validate-license.d.ts","sourceRoot":"","sources":["../src/validate-license.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAoBjF"}

package/dist/validate-license.js

@@ -1,4 +1,4 @@
-import { getSystemDb } from "@nebutra/db";
+import { requireLicenseDb } from "./db";
 /**
  * Validate a license key.
  *
@@ -6,11 +6,13 @@ import { getSystemDb } from "@nebutra/db";
  * Used by the CLI `nebutra license activate` and the public
  * `/api/license/validate` endpoint.
  *
+ * Requires `configureLicenseSystemDb(getSystemDb)` at host bootstrap.
+ *
  * AUDIT(no-tenant): licenses are keyed on userId and are not scoped to any
  * Organization; the validate flow runs pre-auth against a global key space.
  */
 export async function validateLicense(key) {
-    const license = await getSystemDb().license.findFirst({
+    const license = await requireLicenseDb().license.findFirst({
         where: { licenseKey: key, isActive: true },
         select: { tier: true, type: true, expiresAt: true },
     });

package/package.json

@@ -1,14 +1,27 @@
 {
   "name": "@nebutra/license",
-  "version": "0.1.3",
+  "version": "2.0.0",
   "description": "License domain logic — issuance, validation, and lifecycle events",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "core",
     "featureId": "license",
     "category": "commerce",
-    "summary": "License key generation + validation"
+    "summary": "License key generation + validation",
+    "status": "foundation",
+    "productionReady": false,
+    "requires": [
+      "Host-injected getSystemDb via configureLicenseSystemDb",
+      "@nebutra/queue for license.issued fan-out",
+      "@nebutra/email for welcome mail (handler)"
+    ],
+    "gaps": [
+      "Persistence is host-injected — the package defines a LicenseDb interface and deliberately never imports @nebutra/db",
+      "Issuance sends through @nebutra/email, so a working email provider must be configured before a key reaches anyone",
+      "No UI surface: key entry, activation and portal screens belong to the consuming app"
+    ]
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,23 +41,14 @@
   ],
   "dependencies": {
     "zod": "^4.3.6",
-    "@nebutra/email": "0.1.2",
-    "@nebutra/logger": "0.1.2",
-    "@nebutra/queue": "0.1.3"
-  },
-  "peerDependencies": {
-    "@nebutra/db": "0.1.2"
-  },
-  "peerDependenciesMeta": {
-    "@nebutra/db": {
-      "optional": true
-    }
+    "@nebutra/email": "2.0.0",
+    "@nebutra/logger": "2.0.0",
+    "@nebutra/queue": "2.0.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.4",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.4",
-    "@nebutra/db": "0.1.2"
+    "vitest": "^4.1.4"
   },
   "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/commerce/license#readme",
   "repository": {