@oxyhq/core 1.11.0 → 1.11.1

package/dist/cjs/mixins/OxyServices.topics.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OxyServicesTopicsMixin = OxyServicesTopicsMixin;
+const mixinHelpers_1 = require("./mixinHelpers");
+function OxyServicesTopicsMixin(Base) {
+    return class extends Base {
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * Get top-level topic categories
+         * @param locale - Optional locale for translated results
+         * @returns List of category topics
+         */
+        async getTopicCategories(locale) {
+            try {
+                const params = {};
+                if (locale)
+                    params.locale = locale;
+                return await this.makeRequest('GET', '/topics/categories', params, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.EXTRA_LONG,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Search topics by query string
+         * @param query - Search query
+         * @param limit - Optional result limit
+         * @returns Matching topics
+         */
+        async searchTopics(query, limit) {
+            try {
+                const params = { q: query };
+                if (limit)
+                    params.limit = limit;
+                return await this.makeRequest('GET', '/topics/search', params, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * List topics with optional filters
+         * @param options - Filter and pagination options
+         * @returns List of topics
+         */
+        async listTopics(options) {
+            try {
+                const params = {};
+                if (options?.type)
+                    params.type = options.type;
+                if (options?.q)
+                    params.q = options.q;
+                if (options?.limit)
+                    params.limit = options.limit;
+                if (options?.offset)
+                    params.offset = options.offset;
+                if (options?.locale)
+                    params.locale = options.locale;
+                return await this.makeRequest('GET', '/topics', params, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.SHORT,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Get a single topic by slug
+         * @param slug - Topic slug
+         * @returns Topic data
+         */
+        async getTopicBySlug(slug) {
+            try {
+                return await this.makeRequest('GET', `/topics/${slug}`, undefined, {
+                    cache: true,
+                    cacheTTL: mixinHelpers_1.CACHE_TIMES.LONG,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Resolve an array of topic names to existing or newly created topics
+         * @param names - Array of { name, type } objects to resolve
+         * @returns Resolved topic data
+         */
+        async resolveTopicNames(names) {
+            try {
+                return await this.makeRequest('POST', '/topics/resolve', { names }, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+        /**
+         * Update metadata for a topic
+         * @param slug - Topic slug
+         * @param data - Metadata fields to update
+         * @returns Updated topic data
+         */
+        async updateTopicMetadata(slug, data) {
+            try {
+                return await this.makeRequest('PATCH', `/topics/${slug}`, data, {
+                    cache: false,
+                });
+            }
+            catch (error) {
+                throw this.handleError(error);
+            }
+        }
+    };
+}

package/dist/cjs/mixins/OxyServices.user.js

@@ -89,11 +89,22 @@ function OxyServicesUserMixin(Base) {
             }
         }
         /**
-         * Get profile recommendations
+         * Resolve (find or create) a non-local user. All user creation for
+         * external accounts (federated, agent, automated) goes through this
+         * method — calling services never write user data directly.
          */
-        async getProfileRecommendations() {
+        async resolveExternalUser(data) {
+            return this.makeRequest('PUT', '/users/resolve', data);
+        }
+        /**
+         * Get profile recommendations, optionally filtering out specific user types.
+         */
+        async getProfileRecommendations(options) {
+            const params = options?.excludeTypes?.length
+                ? { excludeTypes: options.excludeTypes.join(',') }
+                : undefined;
             return this.withAuthRetry(async () => {
-                return await this.makeRequest('GET', '/profiles/recommendations', undefined, { cache: true });
+                return await this.makeRequest('GET', '/profiles/recommendations', params, { cache: true });
             }, 'getProfileRecommendations');
         }
         /**

package/dist/cjs/mixins/index.js

@@ -26,6 +26,7 @@ const OxyServices_devices_1 = require("./OxyServices.devices");
 const OxyServices_security_1 = require("./OxyServices.security");
 const OxyServices_utility_1 = require("./OxyServices.utility");
 const OxyServices_features_1 = require("./OxyServices.features");
+const OxyServices_topics_1 = require("./OxyServices.topics");
 /**
  * Mixin pipeline - applied in order from first to last.
  *
@@ -62,6 +63,7 @@ const MIXIN_PIPELINE = [
     OxyServices_devices_1.OxyServicesDevicesMixin,
     OxyServices_security_1.OxyServicesSecurityMixin,
     OxyServices_features_1.OxyServicesFeaturesMixin,
+    OxyServices_topics_1.OxyServicesTopicsMixin,
     // Utility (last, can use all above)
     OxyServices_utility_1.OxyServicesUtilityMixin,
 ];

package/dist/cjs/models/Topic.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicSource = exports.TopicType = void 0;
+var TopicType;
+(function (TopicType) {
+    TopicType["CATEGORY"] = "category";
+    TopicType["TOPIC"] = "topic";
+    TopicType["ENTITY"] = "entity";
+})(TopicType || (exports.TopicType = TopicType = {}));
+var TopicSource;
+(function (TopicSource) {
+    TopicSource["SEED"] = "seed";
+    TopicSource["AI"] = "ai";
+    TopicSource["MANUAL"] = "manual";
+    TopicSource["SYSTEM"] = "system";
+})(TopicSource || (exports.TopicSource = TopicSource = {}));