@happyvertical/smrt-profiles 0.30.0

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * TypeScript type definitions for @have/profiles package
+ */
+/**
+ * Handler function interface for reciprocal relationships
+ *
+ * @param from - The profile initiating the relationship
+ * @param to - The target profile
+ * @param context - Optional context profile for tertiary relationships
+ * @param options - Additional options for the handler
+ */
+export declare type ReciprocalHandler = (from: any, to: any, context?: any, options?: any) => Promise<void>;
+
+/**
+ * Validation schema structure for profile metadata fields
+ */
+export declare interface ValidationSchema {
+    /** Type constraint */
+    type?: 'string' | 'number' | 'boolean' | 'date' | 'json';
+    /** Regex pattern for string validation */
+    pattern?: string;
+    /** Minimum string length */
+    minLength?: number;
+    /** Maximum string length */
+    maxLength?: number;
+    /** Minimum numeric value */
+    min?: number;
+    /** Maximum numeric value */
+    max?: number;
+    /** Custom validator function name */
+    custom?: string;
+    /** Custom validation error message */
+    message?: string;
+}
+
+/**
+ * Custom validator function type
+ */
+export declare type ValidatorFunction = (value: any) => boolean | Promise<boolean>;
+
+export { }

package/dist/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Utility functions for profile operations
+ *
+ * Provides standalone helper functions for metadata management,
+ * relationship operations, and validation.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Create a reciprocal relationship between two profiles
+ *
+ * This is a convenience function that creates a relationship and automatically
+ * handles the reciprocal relationship based on the relationship type configuration.
+ *
+ * @param fromProfile - The initiating profile
+ * @param toProfile - The target profile
+ * @param relationshipSlug - The type of relationship
+ * @param contextProfile - Optional context profile for tertiary relationships
+ */
+export declare function createReciprocalRelationship(fromProfile: any, toProfile: any, relationshipSlug: string, contextProfile?: any): Promise<void>;
+
+/**
+ * Find profiles with a specific metadata key-value pair
+ *
+ * @param metafieldSlug - The slug of the metafield to search
+ * @param value - The value to match
+ * @param options - Database and configuration options
+ * @returns Array of matching profile IDs
+ */
+export declare function findProfilesByMeta(metafieldSlug: string, value: any, options?: any): Promise<string[]>;
+
+/**
+ * Retrieve all metadata for a profile as a key-value object
+ *
+ * @param profileId - The UUID of the profile
+ * @param options - Database and configuration options
+ * @returns Object with metafield slugs as keys and values as values
+ */
+export declare function getProfileMetadata(profileId: string, options?: any): Promise<Record<string, any>>;
+
+/**
+ * Set a single metadata value for a profile
+ *
+ * @param profileId - The UUID of the profile
+ * @param metafieldSlug - The slug of the metafield
+ * @param value - The value to set
+ * @param options - Database and configuration options
+ */
+export declare function setProfileMetadata(profileId: string, metafieldSlug: string, value: any, options?: any): Promise<void>;
+
+/**
+ * Validate a metadata value against a metafield's validation schema
+ *
+ * @param metafield - The metafield with validation rules
+ * @param value - The value to validate
+ * @returns True if valid, throws error if invalid
+ */
+export declare function validateMetadataValue(metafield: any, value: any): Promise<boolean>;
+
+export { }

package/dist/utils.js

@@ -0,0 +1,49 @@
+async function getProfileMetadata(profileId, options = {}) {
+  const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DEhmljMY.js").then((n) => n.b);
+  const metadataCollection = await ProfileMetadataCollection.create(
+    options
+  );
+  return await metadataCollection.getMetadataObject(profileId);
+}
+async function setProfileMetadata(profileId, metafieldSlug, value, options = {}) {
+  const { ProfileCollection } = await import("./chunks/ProfileCollection-DU6wUJTO.js").then((n) => n.d);
+  const profileCollection = await ProfileCollection.create(options);
+  const profile = await profileCollection.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-DMKhSHXX.js").then((n) => n.b);
+  const { ProfileMetadataCollection } = await import("./chunks/ProfileMetadataCollection-DEhmljMY.js").then((n) => n.b);
+  const metafieldCollection = await ProfileMetafieldCollection.create(
+    options
+  );
+  const metafield = await metafieldCollection.getBySlug(metafieldSlug);
+  if (!metafield) {
+    throw new Error(`Metafield '${metafieldSlug}' not found`);
+  }
+  const metadataCollection = await ProfileMetadataCollection.create(
+    options
+  );
+  return await metadataCollection.findProfilesByMetadata(metafield.id, value);
+}
+async function createReciprocalRelationship(fromProfile, toProfile, relationshipSlug, contextProfile) {
+  await fromProfile.addRelationship(
+    toProfile,
+    relationshipSlug,
+    contextProfile
+  );
+}
+async function validateMetadataValue(metafield, value) {
+  return await metafield.validateValue(value);
+}
+export {
+  createReciprocalRelationship,
+  findProfilesByMeta,
+  getProfileMetadata,
+  setProfileMetadata,
+  validateMetadataValue
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../src/utils.ts"],"sourcesContent":["/**\n * Utility functions for profile operations\n *\n * Provides standalone helper functions for metadata management,\n * relationship operations, and validation.\n *\n * @packageDocumentation\n */\n\n// Utility functions will be implemented as part of Phase 2\n// This file serves as a placeholder for the API structure\n\n/**\n * Retrieve all metadata for a profile as a key-value object\n *\n * @param profileId - The UUID of the profile\n * @param options - Database and configuration options\n * @returns Object with metafield slugs as keys and values as values\n */\nexport async function getProfileMetadata(\n  profileId: string,\n  options: any = {},\n): Promise<Record<string, any>> {\n  const { ProfileMetadataCollection } = await import(\n    './collections/ProfileMetadataCollection'\n  );\n\n  const metadataCollection = await (ProfileMetadataCollection as any).create(\n    options,\n  );\n\n  return await metadataCollection.getMetadataObject(profileId);\n}\n\n/**\n * Set a single metadata value for a profile\n *\n * @param profileId - The UUID of the profile\n * @param metafieldSlug - The slug of the metafield\n * @param value - The value to set\n * @param options - Database and configuration options\n */\nexport async function setProfileMetadata(\n  profileId: string,\n  metafieldSlug: string,\n  value: any,\n  options: any = {},\n): Promise<void> {\n  const { ProfileCollection } = await import('./collections/ProfileCollection');\n\n  const profileCollection = await (ProfileCollection as any).create(options);\n\n  const profile = await profileCollection.get({ id: profileId });\n  if (!profile) {\n    throw new Error(`Profile '${profileId}' not found`);\n  }\n\n  await profile.addMetadata(metafieldSlug, value);\n}\n\n/**\n * Find profiles with a specific metadata key-value pair\n *\n * @param metafieldSlug - The slug of the metafield to search\n * @param value - The value to match\n * @param options - Database and configuration options\n * @returns Array of matching profile IDs\n */\nexport async function findProfilesByMeta(\n  metafieldSlug: string,\n  value: any,\n  options: any = {},\n): Promise<string[]> {\n  const { ProfileMetafieldCollection } = await import(\n    './collections/ProfileMetafieldCollection'\n  );\n  const { ProfileMetadataCollection } = await import(\n    './collections/ProfileMetadataCollection'\n  );\n\n  // Get metafield by slug\n  const metafieldCollection = await (ProfileMetafieldCollection as any).create(\n    options,\n  );\n\n  const metafield = await metafieldCollection.getBySlug(metafieldSlug);\n  if (!metafield) {\n    throw new Error(`Metafield '${metafieldSlug}' not found`);\n  }\n\n  // Find all metadata with this metafield and value\n  const metadataCollection = await (ProfileMetadataCollection as any).create(\n    options,\n  );\n\n  return await metadataCollection.findProfilesByMetadata(metafield.id, value);\n}\n\n/**\n * Create a reciprocal relationship between two profiles\n *\n * This is a convenience function that creates a relationship and automatically\n * handles the reciprocal relationship based on the relationship type configuration.\n *\n * @param fromProfile - The initiating profile\n * @param toProfile - The target profile\n * @param relationshipSlug - The type of relationship\n * @param contextProfile - Optional context profile for tertiary relationships\n */\nexport async function createReciprocalRelationship(\n  fromProfile: any,\n  toProfile: any,\n  relationshipSlug: string,\n  contextProfile?: any,\n): Promise<void> {\n  // The Profile.addRelationship method already handles reciprocal relationships\n  await fromProfile.addRelationship(\n    toProfile,\n    relationshipSlug,\n    contextProfile,\n  );\n}\n\n/**\n * Validate a metadata value against a metafield's validation schema\n *\n * @param metafield - The metafield with validation rules\n * @param value - The value to validate\n * @returns True if valid, throws error if invalid\n */\nexport async function validateMetadataValue(\n  metafield: any,\n  value: any,\n): Promise<boolean> {\n  // The ProfileMetafield.validateValue method already implements validation\n  return await metafield.validateValue(value);\n}\n"],"names":[],"mappings":"AAmBA,eAAsB,mBACpB,WACA,UAAe,IACe;AAC9B,QAAM,EAAE,0BAAA,IAA8B,MAAM,OAC1C,gDACF,EAAA,KAAA,OAAA,EAAA,CAAA;AAEA,QAAM,qBAAqB,MAAO,0BAAkC;AAAA,IAClE;AAAA,EAAA;AAGF,SAAO,MAAM,mBAAmB,kBAAkB,SAAS;AAC7D;AAUA,eAAsB,mBACpB,WACA,eACA,OACA,UAAe,CAAA,GACA;AACf,QAAM,EAAE,kBAAA,IAAsB,MAAM,OAAO,wCAAiC,EAAA,KAAA,OAAA,EAAA,CAAA;AAE5E,QAAM,oBAAoB,MAAO,kBAA0B,OAAO,OAAO;AAEzE,QAAM,UAAU,MAAM,kBAAkB,IAAI,EAAE,IAAI,WAAW;AAC7D,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,YAAY,SAAS,aAAa;AAAA,EACpD;AAEA,QAAM,QAAQ,YAAY,eAAe,KAAK;AAChD;AAUA,eAAsB,mBACpB,eACA,OACA,UAAe,CAAA,GACI;AACnB,QAAM,EAAE,2BAAA,IAA+B,MAAM,OAC3C,iDACF,EAAA,KAAA,OAAA,EAAA,CAAA;AACA,QAAM,EAAE,0BAAA,IAA8B,MAAM,OAC1C,gDACF,EAAA,KAAA,OAAA,EAAA,CAAA;AAGA,QAAM,sBAAsB,MAAO,2BAAmC;AAAA,IACpE;AAAA,EAAA;AAGF,QAAM,YAAY,MAAM,oBAAoB,UAAU,aAAa;AACnE,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,cAAc,aAAa,aAAa;AAAA,EAC1D;AAGA,QAAM,qBAAqB,MAAO,0BAAkC;AAAA,IAClE;AAAA,EAAA;AAGF,SAAO,MAAM,mBAAmB,uBAAuB,UAAU,IAAI,KAAK;AAC5E;AAaA,eAAsB,6BACpB,aACA,WACA,kBACA,gBACe;AAEf,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AASA,eAAsB,sBACpB,WACA,OACkB;AAElB,SAAO,MAAM,UAAU,cAAc,KAAK;AAC5C;"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@happyvertical/smrt-profiles",
+  "version": "0.30.0",
+  "description": "Profile management system with relationships, metadata, and reciprocal associations for SMRT framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "dependencies": {
+    "@happyvertical/ai": "^0.74.7",
+    "@happyvertical/files": "^0.74.7",
+    "@happyvertical/logger": "^0.74.7",
+    "@happyvertical/sql": "^0.74.7",
+    "@happyvertical/utils": "^0.74.7",
+    "@noble/curves": "^1.8.1",
+    "bech32": "^2.0.0",
+    "@happyvertical/smrt-assets": "0.30.0",
+    "@happyvertical/smrt-core": "0.30.0",
+    "@happyvertical/smrt-prompts": "0.30.0",
+    "@happyvertical/smrt-tenancy": "0.30.0"
+  },
+  "devDependencies": {
+    "@faker-js/faker": "^10.2.0",
+    "@types/node": "25.0.9",
+    "fast-glob": "3.3.3",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-vitest": "0.30.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "profiles",
+    "relationships",
+    "metadata",
+    "smrt"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/profiles"
+  },
+  "scripts": {
+    "build": "vite build --mode library",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "vite dev",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}