@happyvertical/smrt-profiles 0.51.13 → 0.51.14

package/dist/internal/oidc-provisioning.d.ts

@@ -1,17 +1,122 @@
-import { getDatabase } from '@happyvertical/sql';
-import { OidcProvisioningIdentityInput, OidcProvisioningPersonInput } from '../auth/oidcProvisioningPrimitives';
-export { coordinateOidcProvisioning, isOidcAbortedTransactionError, isOidcProvisioningRaceConflict, type OidcProvisioningCoordinatorOptions, type OidcProvisioningRaceClassifierOptions, saveOidcRaceArbiter, } from '../auth/oidcProvisioningCoordinator.js';
-type DatabaseInterface = Awaited<ReturnType<typeof getDatabase>>;
-export type { OidcProvisioningIdentityInput, OidcProvisioningPersonInput };
+import { getDatabase } from '@happyvertical/sql';
+
+/**
+ * Coordinate one OIDC provisioning operation across adapters.
+ *
+ * Root adapters must expose `beginTransaction`. Already-bound adapters must
+ * support savepoints. An adapter that exposes only `transaction()` is
+ * intentionally ambiguous and fails closed instead of risking a nested
+ * transaction that could roll back its caller's work.
+ */
+export declare function coordinateOidcProvisioning<T>(options: OidcProvisioningCoordinatorOptions<T>): Promise<T>;
+
+/**
+ * Trusted integration surface for framework packages participating in the
+ * owner-aware OIDC provisioning transaction.
+ *
+ * Application code should use UserCollection.getOrCreateFromOidc() instead.
+ * The generic result avoids duplicating nominal SMRT model declarations across
+ * package entry bundles; trusted callers bind it to the root package model.
+ */
+export declare function createOidcProvisioningPerson<TProfile>(db: DatabaseInterface, input: OidcProvisioningPersonInput): Promise<TProfile>;
+
+declare type DatabaseInterface = Awaited<ReturnType<typeof getDatabase>>;
+
+declare type DatabaseInterface_2 = Awaited<ReturnType<typeof getDatabase>>;
+
+/** Trusted integration insert after the caller proves Profile ownership. */
+export declare function insertOidcProvisioningIdentity<TIdentity>(db: DatabaseInterface, input: OidcProvisioningIdentityInput): Promise<TIdentity>;
+
+/**
+ * Detect an adapter error caused by an aborted transaction.
+ *
+ * Reduced to the framework contract in #2366. The heuristic this replaced
+ * matched a bare `/transaction.*aborted/` against every message in the chain,
+ * which would misclassify a genuine foreign-key or check violation whose text
+ * happened to mention a transaction. Core now recognizes PostgreSQL's
+ * `25P02 in_failed_sql_transaction` from the driver's own SQLSTATE, whichever
+ * layer wrapped it.
+ *
+ * Kept as a named export because it is part of this package's provisioning
+ * API surface; the body is now a single delegation.
+ */
+export declare function isOidcAbortedTransactionError(error: unknown): boolean;
+
+/** Classify only the durable constraints used to converge OIDC retries. */
+export declare function isOidcProvisioningRaceConflict(error: unknown, options?: OidcProvisioningRaceClassifierOptions): boolean;
+
+/** Shared transaction and concurrency policy for OIDC provisioning. */
+export declare interface OidcProvisioningCoordinatorOptions<T> {
+    /** Root or transaction-bound database used for every provisioning write. */
+    db: DatabaseInterface_2;
+    /**
+     * Stable keys used for local serialization. Supply both the exact
+     * issuer/subject key and normalized email when available.
+     */
+    lockKeys: readonly string[];
+    /** Package-specific durable race-arbiter classifier. */
+    isRaceConflict: (error: unknown) => boolean;
+    /** Package-specific transaction failure mapping. */
+    createTransactionError: (message: string, cause?: unknown) => Error;
+    /** Package-specific terminal concurrency failure mapping. */
+    createConcurrencyError: (cause?: unknown) => Error;
+    /** Provision atomically using the supplied transaction-bound handle. */
+    provision: (tx: DatabaseInterface_2) => Promise<T>;
+    /**
+     * Rehydrate root-owned results after commit so models do not retain a
+     * released transaction client. Omit for non-model results.
+     */
+    rebindRootResult?: (result: T, rootDb: DatabaseInterface_2) => Promise<T>;
+}
+
+export declare interface OidcProvisioningIdentityInput {
+    email?: string;
+    issuer: string;
+    profileId: string;
+    provider: string;
+    subject: string;
+}
+
+export declare interface OidcProvisioningPersonInput {
+    email?: string;
+    name?: string;
+    preferredUsername?: string;
+    subject: string;
+}
+
+export declare interface OidcProvisioningRaceClassifierOptions {
+    /** Package-specific database constraint messages. */
+    messagePatterns?: readonly RegExp[];
+}
+
+/** Wrap a known OIDC arbiter write so only its unique failure is retryable. */
+export declare function saveOidcRaceArbiter<T>(operation: () => Promise<T>): Promise<T>;
+
+export { }
+
+
 /**
- * Trusted integration surface for framework packages participating in the
- * owner-aware OIDC provisioning transaction.
+ * Extend globalThis to include custom validators registry.
+ * Using globalThis ensures all module instances share the same validators,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
  *
- * Application code should use UserCollection.getOrCreateFromOidc() instead.
- * The generic result avoids duplicating nominal SMRT model declarations across
- * package entry bundles; trusted callers bind it to the root package model.
+ * @see https://github.com/happyvertical/smrt/issues/543
  */
-export declare function createOidcProvisioningPerson<TProfile>(db: DatabaseInterface, input: OidcProvisioningPersonInput): Promise<TProfile>;
-/** Trusted integration insert after the caller proves Profile ownership. */
-export declare function insertOidcProvisioningIdentity<TIdentity>(db: DatabaseInterface, input: OidcProvisioningIdentityInput): Promise<TIdentity>;
-//# sourceMappingURL=oidc-provisioning.d.ts.map
+declare global {
+    var __smrtProfileMetafieldValidators: Map<string, ValidatorFunction> | undefined;
+}
+
+
+/**
+ * Extend globalThis to include reciprocal handlers registry.
+ * Using globalThis ensures all module instances share the same handlers,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileRelationshipHandlers: Map<string, ReciprocalHandler> | undefined;
+    var __smrtProfileRelationshipHandlersInitialized: boolean | undefined;
+}

package/dist/internal/oidc-provisioning.js

@@ -1,5 +1,5 @@
-import { d as isOidcProvisioningRaceConflict, f as saveOidcRaceArbiter, l as coordinateOidcProvisioning, u as isOidcAbortedTransactionError } from "../chunks/ProfileCollection-BAC5weFA.js";
-import { n as insertOidcProvisioningIdentity$1, t as createOidcProvisioningPerson$1 } from "../chunks/oidcProvisioningPrimitives-BPWWsNb7.js";
+import { d as isOidcProvisioningRaceConflict, f as saveOidcRaceArbiter, l as coordinateOidcProvisioning, u as isOidcAbortedTransactionError } from "../chunks/ProfileCollection-BvhD2cfL.js";
+import { n as insertOidcProvisioningIdentity$1, t as createOidcProvisioningPerson$1 } from "../chunks/oidcProvisioningPrimitives-CjOkg3Zd.js";
 //#region src/internal/oidc-provisioning.ts
 async function createOidcProvisioningPerson(db, input) {
 	return await createOidcProvisioningPerson$1(db, input);

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-profiles",
-  "packageVersion": "0.51.13",
+  "packageVersion": "0.51.14",
   "objects": {
     "@happyvertical/smrt-profiles:ApiKeyCollection": {
       "name": "apikeycollection",

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-profiles",
-  "packageVersion": "0.51.13",
+  "packageVersion": "0.51.14",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "7be5d453d8a676acd73e4a996264afac31d7d280ee9aa2bfee5b3ed16d629dbf",
-    "packageJson": "d7c7edb4c6635aaaa3a8bfe419dbfbbe193433b466e74224500f3e5e616cc630",
+    "manifest": "fd4b885e86b483bc28e909108df790e00f4ee0963883efda4fcf2d4e1a8ab71d",
+    "packageJson": "b16df0713df2f1d01d371175a71780c776cd4fd36bf4001c7e54481f8d5de35d",
     "agents": "a6646a088f8c421b5556f945946db6f83d3a23d77b34c40bb02b726af30b4bd2"
   },
   "exports": [
@@ -28,11 +28,11 @@
     "@happyvertical/smrt-tenancy": "workspace:*",
     "@happyvertical/sql": "catalog:",
     "@happyvertical/utils": "catalog:",
-    "@noble/curves": "^1.9.7",
+    "@noble/curves": "^2.4.0",
     "bech32": "^2.0.0",
-    "@faker-js/faker": "^10.5.0",
+    "@faker-js/faker": "^10.6.0",
     "@happyvertical/smrt-vitest": "workspace:*",
-    "@types/node": "24.13.2",
+    "@types/node": "24.13.6",
     "fast-glob": "3.3.3",
     "typescript": "5.9.3",
     "vite": "8.1.4",

package/dist/types.d.ts

@@ -709,3 +709,30 @@ export declare interface ValidationSchema {
 export declare type ValidatorFunction = (value: unknown) => boolean | Promise<boolean>;
 
 export { }
+
+
+/**
+ * Extend globalThis to include custom validators registry.
+ * Using globalThis ensures all module instances share the same validators,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileMetafieldValidators: Map<string, ValidatorFunction> | undefined;
+}
+
+
+/**
+ * Extend globalThis to include reciprocal handlers registry.
+ * Using globalThis ensures all module instances share the same handlers,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileRelationshipHandlers: Map<string, ReciprocalHandler> | undefined;
+    var __smrtProfileRelationshipHandlersInitialized: boolean | undefined;
+}

package/dist/utils.d.ts

@@ -794,3 +794,30 @@ declare interface ValidationSchema {
 declare type ValidatorFunction = (value: unknown) => boolean | Promise<boolean>;
 
 export { }
+
+
+/**
+ * Extend globalThis to include custom validators registry.
+ * Using globalThis ensures all module instances share the same validators,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileMetafieldValidators: Map<string, ValidatorFunction> | undefined;
+}
+
+
+/**
+ * Extend globalThis to include reciprocal handlers registry.
+ * Using globalThis ensures all module instances share the same handlers,
+ * which is critical in monorepos where the same package can be loaded
+ * from different paths (e.g., pnpm store vs workspace symlink).
+ *
+ * @see https://github.com/happyvertical/smrt/issues/543
+ */
+declare global {
+    var __smrtProfileRelationshipHandlers: Map<string, ReciprocalHandler> | undefined;
+    var __smrtProfileRelationshipHandlersInitialized: boolean | undefined;
+}

package/dist/utils.js

@@ -1,17 +1,17 @@
 //#region src/utils.ts
 async function getProfileMetadata(profileId, options = {}) {
-	const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DyVxb-Tn.js").then((n) => n.n);
+	const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DxX_BJKV.js").then((n) => n.n);
 	return await (await ProfileMetadataCollection.create(options)).getMetadataObject(profileId);
 }
 async function setProfileMetadata(profileId, metafieldSlug, value, options = {}) {
-	const { ProfileCollection } = await import("./chunks/ProfileCollection-BAC5weFA.js").then((n) => n.r);
+	const { ProfileCollection } = await import("./chunks/ProfileCollection-BvhD2cfL.js").then((n) => n.r);
 	const profile = await (await ProfileCollection.create(options)).get({ id: profileId });
 	if (!profile) throw new Error(`Profile '${profileId}' not found`);
 	await profile.addMetadata(metafieldSlug, value);
 }
 async function findProfilesByMeta(metafieldSlug, value, options = {}) {
-	const { ProfileMetafieldCollection } = await import("./chunks/ProfileMetafieldCollection-KSYFXBxU.js").then((n) => n.n);
-	const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DyVxb-Tn.js").then((n) => n.n);
+	const { ProfileMetafieldCollection } = await import("./chunks/ProfileMetafieldCollection-CMKhVi2I.js").then((n) => n.n);
+	const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DxX_BJKV.js").then((n) => n.n);
 	const metafield = await (await ProfileMetafieldCollection.create(options)).getBySlug(metafieldSlug);
 	if (!metafield) throw new Error(`Metafield '${metafieldSlug}' not found`);
 	return await (await ProfileMetadataCollection.create(options)).findProfilesByMetadata(metafield.id, value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-profiles",
-  "version": "0.51.13",
+  "version": "0.51.14",
   "description": "Profile management system with relationships, metadata, and reciprocal associations for SMRT framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
       "import": "./dist/utils.js"
     },
     "./internal/oidc-provisioning": {
-      "types": "./dist/oidc-provisioning.d.ts",
+      "types": "./dist/internal/oidc-provisioning.d.ts",
       "import": "./dist/internal/oidc-provisioning.js"
     },
     "./manifest": "./dist/manifest.json",
@@ -30,19 +30,19 @@
     "@happyvertical/ai": "^0.89.12",
     "@happyvertical/files": "^0.89.12",
     "@happyvertical/logger": "^0.89.12",
-    "@happyvertical/smrt-assets": "0.51.13",
-    "@happyvertical/smrt-core": "0.51.13",
-    "@happyvertical/smrt-prompts": "0.51.13",
-    "@happyvertical/smrt-tenancy": "0.51.13",
+    "@happyvertical/smrt-assets": "0.51.14",
+    "@happyvertical/smrt-core": "0.51.14",
+    "@happyvertical/smrt-prompts": "0.51.14",
+    "@happyvertical/smrt-tenancy": "0.51.14",
     "@happyvertical/sql": "^0.89.12",
     "@happyvertical/utils": "^0.89.12",
-    "@noble/curves": "^1.9.7",
+    "@noble/curves": "^2.4.0",
     "bech32": "^2.0.0"
   },
   "devDependencies": {
-    "@faker-js/faker": "^10.5.0",
-    "@happyvertical/smrt-vitest": "0.51.13",
-    "@types/node": "24.13.2",
+    "@faker-js/faker": "^10.6.0",
+    "@happyvertical/smrt-vitest": "0.51.14",
+    "@types/node": "24.13.6",
     "fast-glob": "3.3.3",
     "typescript": "5.9.3",
     "vite": "8.1.4",