@veruna/api-contracts 1.0.44 → 1.0.45

package/build/controllers/index.d.ts

@@ -15,3 +15,4 @@ export { MESSAGE_UNREG_CONTROLLER, MESSAGE_REG_CONTROLLER } from './message.cont
 export { VERIFICATION_CONTROLLER } from './verification.controllers';
 export { SITEMAP_CONTROLLER } from './sitemap.controllers';
 export { WALLET_CONTROLLER } from './wallet.controllers';
+export { PAGE_HINTS_ADMIN_CONTROLLER } from './page-hints.controllers';

package/build/controllers/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WALLET_CONTROLLER = exports.SITEMAP_CONTROLLER = exports.VERIFICATION_CONTROLLER = exports.MESSAGE_REG_CONTROLLER = exports.MESSAGE_UNREG_CONTROLLER = exports.CHAT_HISTORY_CONTROLLER = exports.CHAT_REG_CONTROLLER = exports.CHAT_UNREG_CONTROLLER = exports.CHAT_PROJECT_CONTROLLER = exports.FILE_CONTROLLER = exports.AI_MODEL_UNREG_CONTROLLER = exports.AI_MODEL_PUBLIC_CONTROLLER = exports.AI_MODEL_ADMIN_CONTROLLER = exports.AI_PROVIDER_PUBLIC_CONTROLLER = exports.AI_PROVIDER_ADMIN_CONTROLLER = exports.SEO_PAGES_PUBLIC_CONTROLLER = exports.SEO_PAGES_ADMIN_CONTROLLER = exports.BLOG_PUBLIC_POSTS_CONTROLLER = exports.BLOG_PUBLIC_CATEGORIES_CONTROLLER = exports.BLOG_ADMIN_POSTS_CONTROLLER = exports.BLOG_ADMIN_CATEGORIES_CONTROLLER = exports.UNREG_USERS_CONTROLLER = exports.USERS_CONTROLLER = exports.AUTH_CONTROLLER = void 0;
+exports.PAGE_HINTS_ADMIN_CONTROLLER = exports.WALLET_CONTROLLER = exports.SITEMAP_CONTROLLER = exports.VERIFICATION_CONTROLLER = exports.MESSAGE_REG_CONTROLLER = exports.MESSAGE_UNREG_CONTROLLER = exports.CHAT_HISTORY_CONTROLLER = exports.CHAT_REG_CONTROLLER = exports.CHAT_UNREG_CONTROLLER = exports.CHAT_PROJECT_CONTROLLER = exports.FILE_CONTROLLER = exports.AI_MODEL_UNREG_CONTROLLER = exports.AI_MODEL_PUBLIC_CONTROLLER = exports.AI_MODEL_ADMIN_CONTROLLER = exports.AI_PROVIDER_PUBLIC_CONTROLLER = exports.AI_PROVIDER_ADMIN_CONTROLLER = exports.SEO_PAGES_PUBLIC_CONTROLLER = exports.SEO_PAGES_ADMIN_CONTROLLER = exports.BLOG_PUBLIC_POSTS_CONTROLLER = exports.BLOG_PUBLIC_CATEGORIES_CONTROLLER = exports.BLOG_ADMIN_POSTS_CONTROLLER = exports.BLOG_ADMIN_CATEGORIES_CONTROLLER = exports.UNREG_USERS_CONTROLLER = exports.USERS_CONTROLLER = exports.AUTH_CONTROLLER = void 0;
 /**
  * Centralized exports for all controllers
  */
@@ -42,3 +42,5 @@ var sitemap_controllers_1 = require("./sitemap.controllers");
 Object.defineProperty(exports, "SITEMAP_CONTROLLER", { enumerable: true, get: function () { return sitemap_controllers_1.SITEMAP_CONTROLLER; } });
 var wallet_controllers_1 = require("./wallet.controllers");
 Object.defineProperty(exports, "WALLET_CONTROLLER", { enumerable: true, get: function () { return wallet_controllers_1.WALLET_CONTROLLER; } });
+var page_hints_controllers_1 = require("./page-hints.controllers");
+Object.defineProperty(exports, "PAGE_HINTS_ADMIN_CONTROLLER", { enumerable: true, get: function () { return page_hints_controllers_1.PAGE_HINTS_ADMIN_CONTROLLER; } });

package/build/controllers/page-hints.controllers.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Page Hints Controller paths for NestJS @Controller decorator
+ */
+export declare const PAGE_HINTS_ADMIN_CONTROLLER: "v1/admin/seo-pages/:pageUuid/hints";

package/build/controllers/page-hints.controllers.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_HINTS_ADMIN_CONTROLLER = void 0;
+/**
+ * Page Hints Controller paths for NestJS @Controller decorator
+ */
+exports.PAGE_HINTS_ADMIN_CONTROLLER = 'v1/admin/seo-pages/:pageUuid/hints';

package/build/rest-api.d.ts

@@ -81,6 +81,15 @@ export declare const REST_API: {
                 readonly GET_BY_ALIAS: (alias: string) => string;
             };
         };
+        readonly PAGE_HINTS: {
+            readonly ADMIN: {
+                readonly CREATE: (pageUuid: string) => string;
+                readonly GET_ALL: (pageUuid: string) => string;
+                readonly GET_BY_UUID: (pageUuid: string, hintUuid: string) => string;
+                readonly UPDATE: (pageUuid: string, hintUuid: string) => string;
+                readonly DELETE: (pageUuid: string, hintUuid: string) => string;
+            };
+        };
         readonly AI_PROVIDER: {
             readonly ADMIN: {
                 readonly CREATE: "/api/v1/admin/ai-providers/";

package/build/rest-api.js

@@ -91,6 +91,16 @@ exports.REST_API = {
                 GET_BY_ALIAS: (alias) => `${exports.ROOT}/${controllers_1.SEO_PAGES_PUBLIC_CONTROLLER}/${alias}`,
             },
         },
+        // Page Hints module (nested under SEO Pages)
+        PAGE_HINTS: {
+            ADMIN: {
+                CREATE: (pageUuid) => `${exports.ROOT}/${controllers_1.PAGE_HINTS_ADMIN_CONTROLLER.replace(':pageUuid', pageUuid)}/${routes_1.PAGE_HINTS_ROUTES.CREATE}`,
+                GET_ALL: (pageUuid) => `${exports.ROOT}/${controllers_1.PAGE_HINTS_ADMIN_CONTROLLER.replace(':pageUuid', pageUuid)}/${routes_1.PAGE_HINTS_ROUTES.GET_ALL}`,
+                GET_BY_UUID: (pageUuid, hintUuid) => `${exports.ROOT}/${controllers_1.PAGE_HINTS_ADMIN_CONTROLLER.replace(':pageUuid', pageUuid)}/${hintUuid}`,
+                UPDATE: (pageUuid, hintUuid) => `${exports.ROOT}/${controllers_1.PAGE_HINTS_ADMIN_CONTROLLER.replace(':pageUuid', pageUuid)}/${hintUuid}`,
+                DELETE: (pageUuid, hintUuid) => `${exports.ROOT}/${controllers_1.PAGE_HINTS_ADMIN_CONTROLLER.replace(':pageUuid', pageUuid)}/${hintUuid}`,
+            },
+        },
         // AI Provider module
         AI_PROVIDER: {
             ADMIN: {

package/build/routes/index.d.ts

@@ -21,3 +21,4 @@ export { MESSAGE_UNREG_ROUTES, MESSAGE_REG_ROUTES } from './message.routes';
 export { VERIFICATION_ROUTES } from './verification.routes';
 export { SITEMAP_ROUTES } from './sitemap.routes';
 export { WALLET_ROUTES } from './wallet.routes';
+export { PAGE_HINTS_ROUTES } from './page-hints.routes';

package/build/routes/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WALLET_ROUTES = exports.SITEMAP_ROUTES = exports.VERIFICATION_ROUTES = exports.MESSAGE_REG_ROUTES = exports.MESSAGE_UNREG_ROUTES = exports.CHAT_HISTORY_ROUTES = exports.CHAT_REG_ROUTES = exports.CHAT_UNREG_ROUTES = exports.CHAT_PROJECT_ROUTES = exports.FILE_ROUTES = exports.AI_MODEL_UNREG_ROUTES = exports.AI_MODEL_PUBLIC_ROUTES = exports.AI_MODEL_ADMIN_ROUTES = exports.AI_PROVIDER_PUBLIC_ROUTES = exports.AI_PROVIDER_ADMIN_ROUTES = exports.SEO_PAGES_PUBLIC_ROUTES = exports.SEO_PAGES_ADMIN_ROUTES = exports.BLOG_PUBLIC_POSTS_ROUTES = exports.BLOG_PUBLIC_CATEGORIES_ROUTES = exports.BLOG_ADMIN_POSTS_ROUTES = exports.BLOG_ADMIN_CATEGORIES_ROUTES = exports.UNREG_USERS_ROUTES = exports.USERS_ROUTES = exports.AUTH_ROUTES = void 0;
+exports.PAGE_HINTS_ROUTES = exports.WALLET_ROUTES = exports.SITEMAP_ROUTES = exports.VERIFICATION_ROUTES = exports.MESSAGE_REG_ROUTES = exports.MESSAGE_UNREG_ROUTES = exports.CHAT_HISTORY_ROUTES = exports.CHAT_REG_ROUTES = exports.CHAT_UNREG_ROUTES = exports.CHAT_PROJECT_ROUTES = exports.FILE_ROUTES = exports.AI_MODEL_UNREG_ROUTES = exports.AI_MODEL_PUBLIC_ROUTES = exports.AI_MODEL_ADMIN_ROUTES = exports.AI_PROVIDER_PUBLIC_ROUTES = exports.AI_PROVIDER_ADMIN_ROUTES = exports.SEO_PAGES_PUBLIC_ROUTES = exports.SEO_PAGES_ADMIN_ROUTES = exports.BLOG_PUBLIC_POSTS_ROUTES = exports.BLOG_PUBLIC_CATEGORIES_ROUTES = exports.BLOG_ADMIN_POSTS_ROUTES = exports.BLOG_ADMIN_CATEGORIES_ROUTES = exports.UNREG_USERS_ROUTES = exports.USERS_ROUTES = exports.AUTH_ROUTES = void 0;
 /**
  * Centralized exports for all routes
  */
@@ -48,3 +48,5 @@ var sitemap_routes_1 = require("./sitemap.routes");
 Object.defineProperty(exports, "SITEMAP_ROUTES", { enumerable: true, get: function () { return sitemap_routes_1.SITEMAP_ROUTES; } });
 var wallet_routes_1 = require("./wallet.routes");
 Object.defineProperty(exports, "WALLET_ROUTES", { enumerable: true, get: function () { return wallet_routes_1.WALLET_ROUTES; } });
+var page_hints_routes_1 = require("./page-hints.routes");
+Object.defineProperty(exports, "PAGE_HINTS_ROUTES", { enumerable: true, get: function () { return page_hints_routes_1.PAGE_HINTS_ROUTES; } });

package/build/routes/page-hints.routes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Page Hints Admin Routes
+ */
+export declare const PAGE_HINTS_ROUTES: {
+    readonly CREATE: "";
+    readonly GET_ALL: "";
+    readonly GET_BY_UUID: ":hintUuid";
+    readonly UPDATE: ":hintUuid";
+    readonly DELETE: ":hintUuid";
+};

package/build/routes/page-hints.routes.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_HINTS_ROUTES = void 0;
+/**
+ * Page Hints Admin Routes
+ */
+exports.PAGE_HINTS_ROUTES = {
+    CREATE: '',
+    GET_ALL: '',
+    GET_BY_UUID: ':hintUuid',
+    UPDATE: ':hintUuid',
+    DELETE: ':hintUuid',
+};

package/build/shared/api-error-response.schema.d.ts

@@ -8,12 +8,14 @@ import { z } from 'zod';
  * @example
  * {
  *   "code": "EMAIL_ALREADY_EXISTS",
+ *   "message": "Email already exists",
  *   "requestId": "41572f77-891e-4d64-9887-6f31b952e0a1"
  * }
  *
  * @example with details (validation errors)
  * {
  *   "code": "VALIDATION_ERROR",
+ *   "message": "Validation failed",
  *   "requestId": "41572f77-891e-4d64-9887-6f31b952e0a1",
  *   "details": {
  *     "email": ["Invalid email format"],
@@ -23,6 +25,7 @@ import { z } from 'zod';
  */
 export declare const ApiErrorResponseSchema: z.ZodObject<{
     code: z.ZodString;
+    message: z.ZodString;
     requestId: z.ZodString;
     details: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodString>, z.ZodString]>>;
 }, z.core.$strip>;

package/build/shared/api-error-response.schema.js

@@ -11,12 +11,14 @@ const zod_1 = require("zod");
  * @example
  * {
  *   "code": "EMAIL_ALREADY_EXISTS",
+ *   "message": "Email already exists",
  *   "requestId": "41572f77-891e-4d64-9887-6f31b952e0a1"
  * }
  *
  * @example with details (validation errors)
  * {
  *   "code": "VALIDATION_ERROR",
+ *   "message": "Validation failed",
  *   "requestId": "41572f77-891e-4d64-9887-6f31b952e0a1",
  *   "details": {
  *     "email": ["Invalid email format"],
@@ -27,8 +29,12 @@ const zod_1 = require("zod");
 exports.ApiErrorResponseSchema = zod_1.z.object({
     /** Error code for client-side localization and error handling */
     code: zod_1.z.string(),
+    /** Human-readable error message */
+    message: zod_1.z.string(),
     /** Unique request identifier for debugging and support */
     requestId: zod_1.z.string().uuid(),
     /** Optional error details (validation errors, additional context) */
-    details: zod_1.z.union([zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()), zod_1.z.array(zod_1.z.string()), zod_1.z.string()]).optional(),
+    details: zod_1.z
+        .union([zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()), zod_1.z.array(zod_1.z.string()), zod_1.z.string()])
+        .optional(),
 });

package/build/v1/ai-model/admin/commands/create-model.command.d.ts

@@ -14,7 +14,7 @@ export declare namespace AdminAiModelCreateCommand {
         speed: z.ZodDefault<z.ZodNumber>;
         bestFor: z.ZodDefault<z.ZodArray<z.ZodString>>;
         usageExamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        contextLength: z.ZodDefault<z.ZodBigInt>;
+        contextLength: z.ZodDefault<z.ZodNumber>;
         apiProvider: z.ZodDefault<z.ZodEnum<typeof import("../../schemas").ApiProvider>>;
         inputModalities: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof import("../../schemas").Modality>>>;
         outputModalities: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof import("../../schemas").Modality>>>;

package/build/v1/ai-model/admin/commands/update-model.command.d.ts

@@ -14,7 +14,7 @@ export declare namespace AdminAiModelUpdateCommand {
         speed: z.ZodOptional<z.ZodNumber>;
         bestFor: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usageExamples: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        contextLength: z.ZodOptional<z.ZodBigInt>;
+        contextLength: z.ZodOptional<z.ZodNumber>;
         apiProvider: z.ZodOptional<z.ZodEnum<typeof import("../../schemas").ApiProvider>>;
         inputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../../schemas").Modality>>>;
         outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../../schemas").Modality>>>;

package/build/v1/ai-model/schemas/create-model-request.schema.d.ts

@@ -17,7 +17,7 @@ export declare const CreateModelRequestSchema: z.ZodObject<{
     speed: z.ZodDefault<z.ZodNumber>;
     bestFor: z.ZodDefault<z.ZodArray<z.ZodString>>;
     usageExamples: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    contextLength: z.ZodDefault<z.ZodBigInt>;
+    contextLength: z.ZodDefault<z.ZodNumber>;
     apiProvider: z.ZodDefault<z.ZodEnum<typeof ApiProvider>>;
     inputModalities: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof Modality>>>;
     outputModalities: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof Modality>>>;

package/build/v1/ai-model/schemas/create-model-request.schema.js

@@ -25,7 +25,7 @@ exports.CreateModelRequestSchema = zod_1.z.object({
     speed: zod_1.z.number().int().min(1).max(5).default(3),
     bestFor: zod_1.z.array(zod_1.z.string()).default([]),
     usageExamples: zod_1.z.array(zod_1.z.string()).default([]),
-    contextLength: zod_1.z.bigint().positive().default(BigInt(128000)),
+    contextLength: zod_1.z.number().int().positive().default(128000),
     apiProvider: zod_1.z.nativeEnum(api_provider_enum_1.ApiProvider).default(api_provider_enum_1.ApiProvider.OPENROUTER),
     inputModalities: zod_1.z.array(zod_1.z.nativeEnum(modality_enum_1.Modality)).default([modality_enum_1.Modality.TEXT]),
     outputModalities: zod_1.z.array(zod_1.z.nativeEnum(modality_enum_1.Modality)).default([modality_enum_1.Modality.TEXT]),

package/build/v1/ai-model/schemas/update-model-request.schema.d.ts

@@ -17,7 +17,7 @@ export declare const UpdateModelRequestSchema: z.ZodObject<{
     speed: z.ZodOptional<z.ZodNumber>;
     bestFor: z.ZodOptional<z.ZodArray<z.ZodString>>;
     usageExamples: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    contextLength: z.ZodOptional<z.ZodBigInt>;
+    contextLength: z.ZodOptional<z.ZodNumber>;
     apiProvider: z.ZodOptional<z.ZodEnum<typeof ApiProvider>>;
     inputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof Modality>>>;
     outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof Modality>>>;

package/build/v1/ai-model/schemas/update-model-request.schema.js

@@ -26,7 +26,7 @@ exports.UpdateModelRequestSchema = zod_1.z.object({
     speed: zod_1.z.number().int().min(1).max(5).optional(),
     bestFor: zod_1.z.array(zod_1.z.string()).optional(),
     usageExamples: zod_1.z.array(zod_1.z.string()).optional(),
-    contextLength: zod_1.z.bigint().positive().optional(),
+    contextLength: zod_1.z.number().int().positive().optional(),
     apiProvider: zod_1.z.nativeEnum(api_provider_enum_1.ApiProvider).optional(),
     inputModalities: zod_1.z.array(zod_1.z.nativeEnum(modality_enum_1.Modality)).optional(),
     outputModalities: zod_1.z.array(zod_1.z.nativeEnum(modality_enum_1.Modality)).optional(),

package/build/v1/index.d.ts

@@ -16,3 +16,4 @@ export * from './sitemap';
 export * from './wallet';
 export * from './email-validation';
 export * from './registration-antifraud';
+export * from './page-hints';

package/build/v1/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./sitemap"), exports);
 __exportStar(require("./wallet"), exports);
 __exportStar(require("./email-validation"), exports);
 __exportStar(require("./registration-antifraud"), exports);
+__exportStar(require("./page-hints"), exports);

package/build/v1/page-hints/admin/commands/create-hint.command.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../../shared/http-method';
+export declare namespace AdminCreateHintCommand {
+    const Request: z.ZodObject<{
+        icon: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        uuid: z.ZodString;
+        icon: z.ZodString;
+        title: z.ZodString;
+        pageId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    const URL: (pageUuid: string) => string;
+    const METHOD = HttpMethod.POST;
+    type RequestType = z.infer<typeof Request>;
+    type ResponseType = z.infer<typeof Response>;
+}

package/build/v1/page-hints/admin/commands/create-hint.command.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminCreateHintCommand = void 0;
+const schemas_1 = require("../../schemas");
+const http_method_1 = require("../../../../shared/http-method");
+const rest_api_1 = require("../../../../rest-api");
+var AdminCreateHintCommand;
+(function (AdminCreateHintCommand) {
+    AdminCreateHintCommand.Request = schemas_1.CreateHintRequestSchema;
+    AdminCreateHintCommand.Response = schemas_1.HintResponseSchema;
+    AdminCreateHintCommand.URL = rest_api_1.REST_API.V1.PAGE_HINTS.ADMIN.CREATE;
+    AdminCreateHintCommand.METHOD = http_method_1.HttpMethod.POST;
+})(AdminCreateHintCommand || (exports.AdminCreateHintCommand = AdminCreateHintCommand = {}));

package/build/v1/page-hints/admin/commands/delete-hint.command.d.ts

@@ -0,0 +1,5 @@
+import { HttpMethod } from '../../../../shared/http-method';
+export declare namespace AdminDeleteHintCommand {
+    const URL: (pageUuid: string, hintUuid: string) => string;
+    const METHOD = HttpMethod.DELETE;
+}

package/build/v1/page-hints/admin/commands/delete-hint.command.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminDeleteHintCommand = void 0;
+const http_method_1 = require("../../../../shared/http-method");
+const rest_api_1 = require("../../../../rest-api");
+var AdminDeleteHintCommand;
+(function (AdminDeleteHintCommand) {
+    AdminDeleteHintCommand.URL = rest_api_1.REST_API.V1.PAGE_HINTS.ADMIN.DELETE;
+    AdminDeleteHintCommand.METHOD = http_method_1.HttpMethod.DELETE;
+})(AdminDeleteHintCommand || (exports.AdminDeleteHintCommand = AdminDeleteHintCommand = {}));

package/build/v1/page-hints/admin/commands/index.d.ts

@@ -0,0 +1,3 @@
+export { AdminCreateHintCommand } from './create-hint.command';
+export { AdminUpdateHintCommand } from './update-hint.command';
+export { AdminDeleteHintCommand } from './delete-hint.command';

package/build/v1/page-hints/admin/commands/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminDeleteHintCommand = exports.AdminUpdateHintCommand = exports.AdminCreateHintCommand = void 0;
+var create_hint_command_1 = require("./create-hint.command");
+Object.defineProperty(exports, "AdminCreateHintCommand", { enumerable: true, get: function () { return create_hint_command_1.AdminCreateHintCommand; } });
+var update_hint_command_1 = require("./update-hint.command");
+Object.defineProperty(exports, "AdminUpdateHintCommand", { enumerable: true, get: function () { return update_hint_command_1.AdminUpdateHintCommand; } });
+var delete_hint_command_1 = require("./delete-hint.command");
+Object.defineProperty(exports, "AdminDeleteHintCommand", { enumerable: true, get: function () { return delete_hint_command_1.AdminDeleteHintCommand; } });

package/build/v1/page-hints/admin/commands/update-hint.command.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../../shared/http-method';
+export declare namespace AdminUpdateHintCommand {
+    const Request: z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        uuid: z.ZodString;
+        icon: z.ZodString;
+        title: z.ZodString;
+        pageId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    const URL: (pageUuid: string, hintUuid: string) => string;
+    const METHOD = HttpMethod.PATCH;
+    type RequestType = z.infer<typeof Request>;
+    type ResponseType = z.infer<typeof Response>;
+}

package/build/v1/page-hints/admin/commands/update-hint.command.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminUpdateHintCommand = void 0;
+const schemas_1 = require("../../schemas");
+const http_method_1 = require("../../../../shared/http-method");
+const rest_api_1 = require("../../../../rest-api");
+var AdminUpdateHintCommand;
+(function (AdminUpdateHintCommand) {
+    AdminUpdateHintCommand.Request = schemas_1.UpdateHintRequestSchema;
+    AdminUpdateHintCommand.Response = schemas_1.HintResponseSchema;
+    AdminUpdateHintCommand.URL = rest_api_1.REST_API.V1.PAGE_HINTS.ADMIN.UPDATE;
+    AdminUpdateHintCommand.METHOD = http_method_1.HttpMethod.PATCH;
+})(AdminUpdateHintCommand || (exports.AdminUpdateHintCommand = AdminUpdateHintCommand = {}));

package/build/v1/page-hints/admin/queries/get-hint.query.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../../shared/http-method';
+export declare namespace AdminGetHintQuery {
+    const Response: z.ZodObject<{
+        uuid: z.ZodString;
+        icon: z.ZodString;
+        title: z.ZodString;
+        pageId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    const URL: (pageUuid: string, hintUuid: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ResponseType = z.infer<typeof Response>;
+}

package/build/v1/page-hints/admin/queries/get-hint.query.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminGetHintQuery = void 0;
+const schemas_1 = require("../../schemas");
+const http_method_1 = require("../../../../shared/http-method");
+const rest_api_1 = require("../../../../rest-api");
+var AdminGetHintQuery;
+(function (AdminGetHintQuery) {
+    AdminGetHintQuery.Response = schemas_1.HintResponseSchema;
+    AdminGetHintQuery.URL = rest_api_1.REST_API.V1.PAGE_HINTS.ADMIN.GET_BY_UUID;
+    AdminGetHintQuery.METHOD = http_method_1.HttpMethod.GET;
+})(AdminGetHintQuery || (exports.AdminGetHintQuery = AdminGetHintQuery = {}));

package/build/v1/page-hints/admin/queries/get-hints.query.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../../shared/http-method';
+export declare namespace AdminGetHintsQuery {
+    const Response: z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        icon: z.ZodString;
+        title: z.ZodString;
+        pageId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    const URL: (pageUuid: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ResponseType = z.infer<typeof Response>;
+}

package/build/v1/page-hints/admin/queries/get-hints.query.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminGetHintsQuery = void 0;
+const zod_1 = require("zod");
+const schemas_1 = require("../../schemas");
+const http_method_1 = require("../../../../shared/http-method");
+const rest_api_1 = require("../../../../rest-api");
+var AdminGetHintsQuery;
+(function (AdminGetHintsQuery) {
+    AdminGetHintsQuery.Response = zod_1.z.array(schemas_1.HintResponseSchema);
+    AdminGetHintsQuery.URL = rest_api_1.REST_API.V1.PAGE_HINTS.ADMIN.GET_ALL;
+    AdminGetHintsQuery.METHOD = http_method_1.HttpMethod.GET;
+})(AdminGetHintsQuery || (exports.AdminGetHintsQuery = AdminGetHintsQuery = {}));

package/build/v1/page-hints/admin/queries/index.d.ts

@@ -0,0 +1,2 @@
+export { AdminGetHintsQuery } from './get-hints.query';
+export { AdminGetHintQuery } from './get-hint.query';

package/build/v1/page-hints/admin/queries/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminGetHintQuery = exports.AdminGetHintsQuery = void 0;
+var get_hints_query_1 = require("./get-hints.query");
+Object.defineProperty(exports, "AdminGetHintsQuery", { enumerable: true, get: function () { return get_hints_query_1.AdminGetHintsQuery; } });
+var get_hint_query_1 = require("./get-hint.query");
+Object.defineProperty(exports, "AdminGetHintQuery", { enumerable: true, get: function () { return get_hint_query_1.AdminGetHintQuery; } });

package/build/v1/page-hints/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Centralized exports for Page Hints contracts
+ */
+export { PageHintErrorCode, PAGE_HINT_ERRORS } from './page-hints.errors';
+export * from './schemas';
+export * from './admin/commands';
+export * from './admin/queries';

package/build/v1/page-hints/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Centralized exports for Page Hints contracts
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_HINT_ERRORS = exports.PageHintErrorCode = void 0;
+// Errors
+var page_hints_errors_1 = require("./page-hints.errors");
+Object.defineProperty(exports, "PageHintErrorCode", { enumerable: true, get: function () { return page_hints_errors_1.PageHintErrorCode; } });
+Object.defineProperty(exports, "PAGE_HINT_ERRORS", { enumerable: true, get: function () { return page_hints_errors_1.PAGE_HINT_ERRORS; } });
+// Schemas
+__exportStar(require("./schemas"), exports);
+// Admin Commands
+__exportStar(require("./admin/commands"), exports);
+// Admin Queries
+__exportStar(require("./admin/queries"), exports);

package/build/v1/page-hints/page-hints.errors.d.ts

@@ -0,0 +1,8 @@
+import { ErrorMetadata } from '../../shared';
+export declare enum PageHintErrorCode {
+    HINT_NOT_FOUND = "HINT_NOT_FOUND",
+    INVALID_HINT_ICON = "INVALID_HINT_ICON",
+    INVALID_HINT_TITLE = "INVALID_HINT_TITLE",
+    HINT_ACCESS_DENIED = "HINT_ACCESS_DENIED"
+}
+export declare const PAGE_HINT_ERRORS: Record<PageHintErrorCode, ErrorMetadata>;

package/build/v1/page-hints/page-hints.errors.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_HINT_ERRORS = exports.PageHintErrorCode = void 0;
+var PageHintErrorCode;
+(function (PageHintErrorCode) {
+    // Not Found (404)
+    PageHintErrorCode["HINT_NOT_FOUND"] = "HINT_NOT_FOUND";
+    // Validation errors (400)
+    PageHintErrorCode["INVALID_HINT_ICON"] = "INVALID_HINT_ICON";
+    PageHintErrorCode["INVALID_HINT_TITLE"] = "INVALID_HINT_TITLE";
+    // Authorization errors (403)
+    PageHintErrorCode["HINT_ACCESS_DENIED"] = "HINT_ACCESS_DENIED";
+})(PageHintErrorCode || (exports.PageHintErrorCode = PageHintErrorCode = {}));
+exports.PAGE_HINT_ERRORS = {
+    [PageHintErrorCode.HINT_NOT_FOUND]: {
+        code: PageHintErrorCode.HINT_NOT_FOUND,
+        statusCode: 404,
+    },
+    [PageHintErrorCode.INVALID_HINT_ICON]: {
+        code: PageHintErrorCode.INVALID_HINT_ICON,
+        statusCode: 400,
+    },
+    [PageHintErrorCode.INVALID_HINT_TITLE]: {
+        code: PageHintErrorCode.INVALID_HINT_TITLE,
+        statusCode: 400,
+    },
+    [PageHintErrorCode.HINT_ACCESS_DENIED]: {
+        code: PageHintErrorCode.HINT_ACCESS_DENIED,
+        statusCode: 403,
+    },
+};

package/build/v1/page-hints/schemas/create-hint-request.schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Create Page Hint Request Schema
+ */
+export declare const CreateHintRequestSchema: z.ZodObject<{
+    icon: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+export type CreateHintRequestType = z.infer<typeof CreateHintRequestSchema>;

package/build/v1/page-hints/schemas/create-hint-request.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateHintRequestSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Create Page Hint Request Schema
+ */
+exports.CreateHintRequestSchema = zod_1.z.object({
+    icon: zod_1.z.string().min(1).max(50),
+    title: zod_1.z.string().min(1).max(255),
+});

package/build/v1/page-hints/schemas/hint-response.schema.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * Full Page Hint Response Schema (for admin)
+ */
+export declare const HintResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    icon: z.ZodString;
+    title: z.ZodString;
+    pageId: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type HintResponseType = z.infer<typeof HintResponseSchema>;
+/**
+ * Public Page Hint Response Schema (minimal fields)
+ */
+export declare const PublicHintResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    icon: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>;
+export type PublicHintResponseType = z.infer<typeof PublicHintResponseSchema>;

package/build/v1/page-hints/schemas/hint-response.schema.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PublicHintResponseSchema = exports.HintResponseSchema = void 0;
+const zod_1 = require("zod");
+const shared_1 = require("../../../shared");
+/**
+ * Full Page Hint Response Schema (for admin)
+ */
+exports.HintResponseSchema = zod_1.z.object({
+    uuid: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    icon: zod_1.z.string(),
+    title: zod_1.z.string(),
+    pageId: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    createdAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX),
+    updatedAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX),
+});
+/**
+ * Public Page Hint Response Schema (minimal fields)
+ */
+exports.PublicHintResponseSchema = zod_1.z.object({
+    uuid: zod_1.z.string().regex(shared_1.UUID_REGEX),
+    icon: zod_1.z.string(),
+    title: zod_1.z.string(),
+});

package/build/v1/page-hints/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export { HintResponseSchema, HintResponseType, PublicHintResponseSchema, PublicHintResponseType, } from './hint-response.schema';
+export { CreateHintRequestSchema, CreateHintRequestType } from './create-hint-request.schema';
+export { UpdateHintRequestSchema, UpdateHintRequestType } from './update-hint-request.schema';

package/build/v1/page-hints/schemas/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateHintRequestSchema = exports.CreateHintRequestSchema = exports.PublicHintResponseSchema = exports.HintResponseSchema = void 0;
+var hint_response_schema_1 = require("./hint-response.schema");
+Object.defineProperty(exports, "HintResponseSchema", { enumerable: true, get: function () { return hint_response_schema_1.HintResponseSchema; } });
+Object.defineProperty(exports, "PublicHintResponseSchema", { enumerable: true, get: function () { return hint_response_schema_1.PublicHintResponseSchema; } });
+var create_hint_request_schema_1 = require("./create-hint-request.schema");
+Object.defineProperty(exports, "CreateHintRequestSchema", { enumerable: true, get: function () { return create_hint_request_schema_1.CreateHintRequestSchema; } });
+var update_hint_request_schema_1 = require("./update-hint-request.schema");
+Object.defineProperty(exports, "UpdateHintRequestSchema", { enumerable: true, get: function () { return update_hint_request_schema_1.UpdateHintRequestSchema; } });

package/build/v1/page-hints/schemas/update-hint-request.schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Update Page Hint Request Schema
+ */
+export declare const UpdateHintRequestSchema: z.ZodObject<{
+    icon: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateHintRequestType = z.infer<typeof UpdateHintRequestSchema>;

package/build/v1/page-hints/schemas/update-hint-request.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateHintRequestSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Update Page Hint Request Schema
+ */
+exports.UpdateHintRequestSchema = zod_1.z.object({
+    icon: zod_1.z.string().min(1).max(50).optional(),
+    title: zod_1.z.string().min(1).max(255).optional(),
+});

package/build/v1/seo-pages/public/queries/get-page-by-alias.query.d.ts

@@ -25,6 +25,11 @@ export declare namespace SeoPageGetPageByAliasQuery {
         marks: z.ZodArray<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
+        hints: z.ZodArray<z.ZodObject<{
+            uuid: z.ZodString;
+            icon: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     const URL: (alias: string) => string;
     const METHOD = HttpMethod.GET;

package/build/v1/seo-pages/public/queries/get-page-by-alias.query.js

@@ -8,7 +8,7 @@ const http_method_1 = require("../../../../shared/http-method");
 var SeoPageGetPageByAliasQuery;
 (function (SeoPageGetPageByAliasQuery) {
     SeoPageGetPageByAliasQuery.Request = zod_1.z.object({});
-    SeoPageGetPageByAliasQuery.Response = schemas_1.PageResponseSchema;
+    SeoPageGetPageByAliasQuery.Response = schemas_1.PublicPageResponseSchema;
     SeoPageGetPageByAliasQuery.URL = (alias) => rest_api_1.REST_API.V1.SEO_PAGES.PUBLIC.GET_BY_ALIAS(alias);
     SeoPageGetPageByAliasQuery.METHOD = http_method_1.HttpMethod.GET;
 })(SeoPageGetPageByAliasQuery || (exports.SeoPageGetPageByAliasQuery = SeoPageGetPageByAliasQuery = {}));

package/build/v1/seo-pages/schemas/index.d.ts

@@ -2,7 +2,7 @@
  * Centralized exports for SEO Pages schemas
  */
 export { PageType } from './page-type.enum';
-export { PageResponseSchema, PageListItemSchema } from './page-response.schema';
+export { PageResponseSchema, PageListItemSchema, PublicPageResponseSchema, type PublicPageResponseType, } from './page-response.schema';
 export { PageHierarchySubItemSchema, PageHierarchyItemSchema, PageHierarchyListSchema, PageHierarchyResponseSchema, type PageHierarchySubItem, type PageHierarchyItem, type PageHierarchyList, type PageHierarchyResponse, } from './page-hierarchy.schema';
 export { CreatePageRequestSchema } from './create-page-request.schema';
 export { UpdatePageRequestSchema } from './update-page-request.schema';

package/build/v1/seo-pages/schemas/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FaqItemSchema = exports.FaqSchema = exports.UpdatePageRequestSchema = exports.CreatePageRequestSchema = exports.PageHierarchyResponseSchema = exports.PageHierarchyListSchema = exports.PageHierarchyItemSchema = exports.PageHierarchySubItemSchema = exports.PageListItemSchema = exports.PageResponseSchema = exports.PageType = void 0;
+exports.FaqItemSchema = exports.FaqSchema = exports.UpdatePageRequestSchema = exports.CreatePageRequestSchema = exports.PageHierarchyResponseSchema = exports.PageHierarchyListSchema = exports.PageHierarchyItemSchema = exports.PageHierarchySubItemSchema = exports.PublicPageResponseSchema = exports.PageListItemSchema = exports.PageResponseSchema = exports.PageType = void 0;
 /**
  * Centralized exports for SEO Pages schemas
  */
@@ -9,6 +9,7 @@ Object.defineProperty(exports, "PageType", { enumerable: true, get: function ()
 var page_response_schema_1 = require("./page-response.schema");
 Object.defineProperty(exports, "PageResponseSchema", { enumerable: true, get: function () { return page_response_schema_1.PageResponseSchema; } });
 Object.defineProperty(exports, "PageListItemSchema", { enumerable: true, get: function () { return page_response_schema_1.PageListItemSchema; } });
+Object.defineProperty(exports, "PublicPageResponseSchema", { enumerable: true, get: function () { return page_response_schema_1.PublicPageResponseSchema; } });
 var page_hierarchy_schema_1 = require("./page-hierarchy.schema");
 Object.defineProperty(exports, "PageHierarchySubItemSchema", { enumerable: true, get: function () { return page_hierarchy_schema_1.PageHierarchySubItemSchema; } });
 Object.defineProperty(exports, "PageHierarchyItemSchema", { enumerable: true, get: function () { return page_hierarchy_schema_1.PageHierarchyItemSchema; } });

package/build/v1/seo-pages/schemas/page-response.schema.d.ts

@@ -47,3 +47,36 @@ export declare const PageListItemSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Public Page Response Schema (with hints)
+ */
+export declare const PublicPageResponseSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    metaTitle: z.ZodString;
+    metaDescription: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    content: z.ZodString;
+    alias: z.ZodString;
+    type: z.ZodEnum<typeof PageType>;
+    icon: z.ZodString;
+    faq: z.ZodObject<{
+        items: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            question: z.ZodString;
+            answer: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    parentId: z.ZodNullable<z.ZodString>;
+    order: z.ZodNumber;
+    placeholder: z.ZodNullable<z.ZodString>;
+    seoName: z.ZodNullable<z.ZodString>;
+    marks: z.ZodArray<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    hints: z.ZodArray<z.ZodObject<{
+        uuid: z.ZodString;
+        icon: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PublicPageResponseType = z.infer<typeof PublicPageResponseSchema>;

package/build/v1/seo-pages/schemas/page-response.schema.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PageListItemSchema = exports.PageResponseSchema = void 0;
+exports.PublicPageResponseSchema = exports.PageListItemSchema = exports.PageResponseSchema = void 0;
 const zod_1 = require("zod");
 const shared_1 = require("../../../shared");
 const page_type_enum_1 = require("./page-type.enum");
 const faq_schema_1 = require("./faq.schema");
+const schemas_1 = require("../../page-hints/schemas");
 /**
  * SEO Page Response Schema (full, with content)
  */
@@ -49,3 +50,9 @@ exports.PageListItemSchema = zod_1.z.object({
     createdAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX),
     updatedAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX),
 });
+/**
+ * Public Page Response Schema (with hints)
+ */
+exports.PublicPageResponseSchema = exports.PageResponseSchema.extend({
+    hints: zod_1.z.array(schemas_1.PublicHintResponseSchema),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veruna/api-contracts",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "API contracts for Veruna project - Zod schemas, types, and paths",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",