@inverted-tech/fragments 0.5.1 → 0.6.1

package/dist/esm/client.js

@@ -0,0 +1,297 @@
+import { create, toJsonString } from '@bufbuild/protobuf';
+import { getValidator } from './validation.js';
+// Safe logging function that works in all environments
+const safeLog = {
+    error: (...args) => {
+        // Use globalThis to safely access console in all environments
+        const globalConsole = globalThis?.console;
+        if (globalConsole && globalConsole.error) {
+            globalConsole.error(...args);
+        }
+    }
+};
+/**
+ * Shared client class for standardized API communication with protobuf serialization
+ *
+ * This client encapsulates common patterns found in action functions like:
+ * - Token retrieval and authentication headers
+ * - Protobuf serialization using create() and toJsonString()
+ * - Consistent error handling with protobuf error responses
+ * - Next.js cache invalidation support (framework-agnostic)
+ * - Pre-request validation using protovalidate
+ */
+export class FragmentsClient {
+    config;
+    validator;
+    // Expose config for testing purposes
+    get _config() {
+        return this.config;
+    }
+    constructor(config = {}) {
+        this.config = {
+            baseUrl: config.baseUrl ?? 'http://localhost:8001',
+            getToken: config.getToken ?? (() => undefined),
+            onCacheInvalidate: config.onCacheInvalidate ?? (() => { }),
+            validateRequests: config.validateRequests ?? false,
+        };
+    }
+    /**
+     * Create a new client instance with modified configuration
+     * @param config Partial configuration to override
+     * @returns New FragmentsClient instance
+     */
+    withConfig(config) {
+        return new FragmentsClient({
+            ...this.config,
+            ...config,
+        });
+    }
+    /**
+     * Generic request method that handles all HTTP operations
+     * @param endpoint API endpoint (relative to baseUrl)
+     * @param reqSchema Request protobuf schema
+     * @param resSchema Response protobuf schema
+     * @param data Request data (optional for GET requests)
+     * @param options Request options
+     * @returns Promise resolving to typed response
+     */
+    async request(endpoint, reqSchema, resSchema, data, options = {}) {
+        const method = options.method ?? 'POST';
+        const shouldValidate = options.validate ?? this.config.validateRequests;
+        // Get authentication token
+        const token = await this.config.getToken();
+        // Create request message if data is provided
+        let requestMessage;
+        let requestBody;
+        if (data && method !== 'GET') {
+            requestMessage = create(reqSchema, data);
+            // Validate request if enabled
+            if (shouldValidate) {
+                const validationResult = await this.validateMessage(reqSchema, requestMessage);
+                if (!validationResult.success) {
+                    // Return error response instead of making HTTP request
+                    return this.createValidationErrorResponse(resSchema, validationResult.violations);
+                }
+            }
+            requestBody = toJsonString(reqSchema, requestMessage);
+        }
+        // Prepare fetch options
+        const fetchOptions = {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                ...(token && { Authorization: `Bearer ${token}` }),
+            },
+            ...(requestBody && { body: requestBody }),
+        };
+        // Add Next.js cache options if provided
+        if (options.cacheTags || options.revalidate !== undefined) {
+            fetchOptions.next = {
+                ...(options.cacheTags && { tags: options.cacheTags }),
+                ...(options.revalidate !== undefined && { revalidate: options.revalidate }),
+            };
+        }
+        try {
+            const url = `${this.config.baseUrl}${endpoint}`;
+            const response = await fetch(url, fetchOptions);
+            // Handle null response like existing action functions
+            if (!response) {
+                safeLog.error('FragmentsClient: Network request failed - no response received');
+                return this.createNetworkErrorResponse(resSchema);
+            }
+            // Handle HTTP errors like existing action functions
+            if (!response.ok) {
+                safeLog.error(`FragmentsClient: HTTP error ${response.status}: ${response.statusText}`);
+                return this.createHttpErrorResponse(resSchema, response.status, response.statusText);
+            }
+            const responseData = await response.json();
+            // Handle cache invalidation for successful mutations
+            if (method !== 'GET' && (options.cacheTags || options.revalidatePaths)) {
+                this.config.onCacheInvalidate(options.cacheTags ?? [], options.revalidatePaths ?? []);
+            }
+            return responseData;
+        }
+        catch (error) {
+            // Log errors like existing action functions using console.error
+            safeLog.error('FragmentsClient request failed:', error);
+            // Return error response instead of throwing, matching existing patterns
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return this.createErrorResponse(resSchema, errorMessage);
+        }
+    }
+    /**
+     * Convenience method for GET requests
+     * @param endpoint API endpoint
+     * @param resSchema Response protobuf schema
+     * @param options Request options
+     * @returns Promise resolving to typed response
+     */
+    async get(endpoint, resSchema, options = {}) {
+        return this.request(endpoint, {}, resSchema, undefined, {
+            ...options,
+            method: 'GET',
+        });
+    }
+    /**
+     * Convenience method for POST requests
+     * @param endpoint API endpoint
+     * @param reqSchema Request protobuf schema
+     * @param resSchema Response protobuf schema
+     * @param data Request data
+     * @param options Request options
+     * @returns Promise resolving to typed response
+     */
+    async post(endpoint, reqSchema, resSchema, data, options = {}) {
+        return this.request(endpoint, reqSchema, resSchema, data, {
+            ...options,
+            method: 'POST',
+        });
+    }
+    /**
+     * Static utility method to create protobuf request messages
+     * @param schema Protobuf message schema
+     * @param data Optional partial data to initialize the message
+     * @returns Created message instance
+     */
+    static createRequest(schema, data) {
+        return create(schema, data);
+    }
+    /**
+     * Static utility method to create protobuf response messages
+     * @param schema Protobuf message schema
+     * @param data Optional partial data to initialize the message
+     * @returns Created message instance
+     */
+    static createResponse(schema, data) {
+        return create(schema, data);
+    }
+    /**
+     * Static utility method to serialize protobuf messages to JSON strings
+     * @param schema Protobuf message schema
+     * @param data Message data to serialize
+     * @returns JSON string representation
+     */
+    static serialize(schema, data) {
+        return toJsonString(schema, data);
+    }
+    /**
+     * Static utility method to validate protobuf messages using protovalidate
+     * @param schema Protobuf message schema
+     * @param data Message data to validate
+     * @returns Promise resolving to validation result
+     */
+    static async validate(schema, data) {
+        try {
+            const validator = await getValidator();
+            const result = validator.validate(schema, data);
+            return {
+                success: result.kind === 'valid',
+                violations: result.kind === 'invalid' ? result.violations : undefined,
+            };
+        }
+        catch (error) {
+            safeLog.error('Validation error:', error);
+            return {
+                success: false,
+                violations: [{ message: 'Validation system error' }],
+            };
+        }
+    }
+    /**
+     * Private method to validate messages using the instance validator
+     */
+    async validateMessage(schema, data) {
+        if (!this.validator) {
+            this.validator = await getValidator();
+        }
+        try {
+            const result = this.validator.validate(schema, data);
+            return {
+                success: result.kind === 'valid',
+                violations: result.kind === 'invalid' ? result.violations : undefined,
+            };
+        }
+        catch (error) {
+            safeLog.error('Validation error:', error);
+            return {
+                success: false,
+                violations: [{ message: 'Validation system error' }],
+            };
+        }
+    }
+    /**
+     * Private method to create error responses matching existing action function patterns
+     * This creates a generic error response structure that matches the patterns used in
+     * existing action functions like modifyPublicSubscriptionSettings
+     */
+    createErrorResponse(schema, message) {
+        // Create error response matching existing action function patterns
+        // The structure matches what's used in functions like modifyPublicSubscriptionSettings
+        return create(schema, {
+            Error: {
+                Message: message,
+                Type: 'SETTINGS_ERROR_UNKNOWN', // Matches SettingsErrorReason.SETTINGS_ERROR_UNKNOWN
+            },
+        });
+    }
+    /**
+     * Private method to create validation error responses
+     * This preserves ValidationIssue[] arrays in error responses as required
+     */
+    createValidationErrorResponse(schema, violations) {
+        return create(schema, {
+            Error: {
+                Message: 'Request validation failed',
+                Type: 'SETTINGS_ERROR_VALIDATION_FAILED', // Matches validation error type
+                Validation: violations ?? [], // Preserve ValidationIssue[] arrays
+            },
+        });
+    }
+    /**
+     * Private method to create HTTP error responses
+     * Handles HTTP errors uniformly like existing action functions
+     */
+    createHttpErrorResponse(schema, status, statusText) {
+        const message = `HTTP ${status}: ${statusText}`;
+        return create(schema, {
+            Error: {
+                Message: message,
+                Type: 'SETTINGS_ERROR_UNKNOWN',
+            },
+        });
+    }
+    /**
+     * Private method to create network error responses
+     * Handles network failures like existing action functions
+     */
+    createNetworkErrorResponse(schema) {
+        return create(schema, {
+            Error: {
+                Message: 'Network request failed',
+                Type: 'SETTINGS_ERROR_UNKNOWN',
+            },
+        });
+    }
+    /**
+     * Static method to create error responses for use in action functions
+     * This allows consumers to create consistent error responses outside of the client
+     * @param schema Response schema to create error for
+     * @param message Error message
+     * @param errorType Error type (defaults to SETTINGS_ERROR_UNKNOWN)
+     * @param validationIssues Optional validation issues array
+     * @returns Error response matching existing action function patterns
+     */
+    static createErrorResponse(schema, message, errorType = 'SETTINGS_ERROR_UNKNOWN', validationIssues) {
+        const errorData = {
+            Message: message,
+            Type: errorType,
+        };
+        // Include validation issues if provided (preserves ValidationIssue[] arrays)
+        if (validationIssues && validationIssues.length > 0) {
+            errorData.Validation = validationIssues;
+        }
+        return create(schema, {
+            Error: errorData,
+        });
+    }
+}

package/dist/esm/google/api/annotations_pb.js

@@ -12,7 +12,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 import { extDesc, fileDesc } from "@bufbuild/protobuf/codegenv2";
-import { file_google_api_http } from "./http_pb";
+import { file_google_api_http } from "./http_pb.js";
 import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file google/api/annotations.proto.

package/dist/esm/index.js

@@ -1,12 +1,12 @@
 // Auto-generated - DO NOT EDIT
-export * from './CommonTypes_pb';
-export * from './Errors_pb';
-export * as Authentication from './Authentication';
-export * as Authorization from './Authorization';
-export * as Comment from './Comment';
-export * as Content from './Content';
-export * as CreatorDashboard from './CreatorDashboard';
-export * as Generic from './Generic';
-export * as Notification from './Notification';
-export * as Page from './Page';
-export * as Settings from './Settings';
+export * from './CommonTypes_pb.js';
+export * from './Errors_pb.js';
+export * as Authentication from './Authentication/index.js';
+export * as Authorization from './Authorization/index.js';
+export * as Comment from './Comment/index.js';
+export * as Content from './Content/index.js';
+export * as CreatorDashboard from './CreatorDashboard/index.js';
+export * as Generic from './Generic/index.js';
+export * as Notification from './Notification/index.js';
+export * as Page from './Page/index.js';
+export * as Settings from './Settings/index.js';

package/dist/esm/validation.js

@@ -2,16 +2,16 @@
 import { createRegistry } from '@bufbuild/protobuf';
 import { createValidator } from '@bufbuild/protovalidate';
 // Import barrels that re-export your generated descriptors (GenFile)
-import * as Auth from './Authentication';
-import * as Authorization from './Authorization';
-import * as Comment from './Comment';
-import * as Content from './Content';
-import * as CreatorDashboard from './CreatorDashboard';
-import * as Generic from './Generic';
-import * as Notification from './Notification';
-import * as Page from './Page';
-import * as Settings from './Settings';
-import * as FragmentsRoot from '.';
+import * as Auth from './Authentication/index.js';
+import * as Authorization from './Authorization/index.js';
+import * as Comment from './Comment/index.js';
+import * as Content from './Content/index.js';
+import * as CreatorDashboard from './CreatorDashboard/index.js';
+import * as Generic from './Generic/index.js';
+import * as Notification from './Notification/index.js';
+import * as Page from './Page/index.js';
+import * as Settings from './Settings/index.js';
+import * as FragmentsRoot from './index.js';
 // Runtime guard (don’t use a type predicate over a module union)
 function looksLikeGenFile(x) {
     const v = x;

package/dist/protos/Authentication/UserInterface_pb.d.ts

@@ -102,40 +102,15 @@ export declare const ChangeOtherPasswordRequestSchema: GenMessage<ChangeOtherPas
  */
 export type ChangeOtherPasswordResponse = Message<"IT.WebServices.Fragments.Authentication.ChangeOtherPasswordResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authentication.ChangeOtherPasswordResponse.ChangeOtherPasswordResponseErrorType Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authentication.AuthError Error = 1;
      */
-    Error: ChangeOtherPasswordResponse_ChangeOtherPasswordResponseErrorType;
+    Error?: AuthError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authentication.ChangeOtherPasswordResponse.
  * Use `create(ChangeOtherPasswordResponseSchema)` to create a new message.
  */
 export declare const ChangeOtherPasswordResponseSchema: GenMessage<ChangeOtherPasswordResponse>;
-/**
- * @generated from enum IT.WebServices.Fragments.Authentication.ChangeOtherPasswordResponse.ChangeOtherPasswordResponseErrorType
- */
-export declare enum ChangeOtherPasswordResponse_ChangeOtherPasswordResponseErrorType {
-    /**
-     * @generated from enum value: NoError = 0;
-     */
-    NoError = 0,
-    /**
-     * @generated from enum value: UnknownError = -1;
-     */
-    UnknownError = -1,
-    /**
-     * @generated from enum value: UserNotFound = 1;
-     */
-    UserNotFound = 1,
-    /**
-     * @generated from enum value: BadNewPassword = 2;
-     */
-    BadNewPassword = 2
-}
-/**
- * Describes the enum IT.WebServices.Fragments.Authentication.ChangeOtherPasswordResponse.ChangeOtherPasswordResponseErrorType.
- */
-export declare const ChangeOtherPasswordResponse_ChangeOtherPasswordResponseErrorTypeSchema: GenEnum<ChangeOtherPasswordResponse_ChangeOtherPasswordResponseErrorType>;
 /**
  * @generated from message IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageRequest
  */
@@ -161,40 +136,15 @@ export declare const ChangeOtherProfileImageRequestSchema: GenMessage<ChangeOthe
  */
 export type ChangeOtherProfileImageResponse = Message<"IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageResponse.ChangeOtherProfileImageResponseErrorType Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authentication.AuthError Error = 1;
      */
-    Error: ChangeOtherProfileImageResponse_ChangeOtherProfileImageResponseErrorType;
+    Error?: AuthError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageResponse.
  * Use `create(ChangeOtherProfileImageResponseSchema)` to create a new message.
  */
 export declare const ChangeOtherProfileImageResponseSchema: GenMessage<ChangeOtherProfileImageResponse>;
-/**
- * @generated from enum IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageResponse.ChangeOtherProfileImageResponseErrorType
- */
-export declare enum ChangeOtherProfileImageResponse_ChangeOtherProfileImageResponseErrorType {
-    /**
-     * @generated from enum value: NoError = 0;
-     */
-    NoError = 0,
-    /**
-     * @generated from enum value: UnknownError = -1;
-     */
-    UnknownError = -1,
-    /**
-     * @generated from enum value: UserNotFound = 1;
-     */
-    UserNotFound = 1,
-    /**
-     * @generated from enum value: BadFormat = 2;
-     */
-    BadFormat = 2
-}
-/**
- * Describes the enum IT.WebServices.Fragments.Authentication.ChangeOtherProfileImageResponse.ChangeOtherProfileImageResponseErrorType.
- */
-export declare const ChangeOtherProfileImageResponse_ChangeOtherProfileImageResponseErrorTypeSchema: GenEnum<ChangeOtherProfileImageResponse_ChangeOtherProfileImageResponseErrorType>;
 /**
  * @generated from message IT.WebServices.Fragments.Authentication.ChangeOwnPasswordRequest
  */
@@ -218,40 +168,15 @@ export declare const ChangeOwnPasswordRequestSchema: GenMessage<ChangeOwnPasswor
  */
 export type ChangeOwnPasswordResponse = Message<"IT.WebServices.Fragments.Authentication.ChangeOwnPasswordResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authentication.ChangeOwnPasswordResponse.ChangeOwnPasswordResponseErrorType Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authentication.AuthError Error = 1;
      */
-    Error: ChangeOwnPasswordResponse_ChangeOwnPasswordResponseErrorType;
+    Error?: AuthError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authentication.ChangeOwnPasswordResponse.
  * Use `create(ChangeOwnPasswordResponseSchema)` to create a new message.
  */
 export declare const ChangeOwnPasswordResponseSchema: GenMessage<ChangeOwnPasswordResponse>;
-/**
- * @generated from enum IT.WebServices.Fragments.Authentication.ChangeOwnPasswordResponse.ChangeOwnPasswordResponseErrorType
- */
-export declare enum ChangeOwnPasswordResponse_ChangeOwnPasswordResponseErrorType {
-    /**
-     * @generated from enum value: NoError = 0;
-     */
-    NoError = 0,
-    /**
-     * @generated from enum value: UnknownError = -1;
-     */
-    UnknownError = -1,
-    /**
-     * @generated from enum value: BadOldPassword = 1;
-     */
-    BadOldPassword = 1,
-    /**
-     * @generated from enum value: BadNewPassword = 2;
-     */
-    BadNewPassword = 2
-}
-/**
- * Describes the enum IT.WebServices.Fragments.Authentication.ChangeOwnPasswordResponse.ChangeOwnPasswordResponseErrorType.
- */
-export declare const ChangeOwnPasswordResponse_ChangeOwnPasswordResponseErrorTypeSchema: GenEnum<ChangeOwnPasswordResponse_ChangeOwnPasswordResponseErrorType>;
 /**
  * @generated from message IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageRequest
  */
@@ -271,36 +196,15 @@ export declare const ChangeOwnProfileImageRequestSchema: GenMessage<ChangeOwnPro
  */
 export type ChangeOwnProfileImageResponse = Message<"IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageResponse.ChangeOwnProfileImageResponseErrorType Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authentication.AuthError Error = 1;
      */
-    Error: ChangeOwnProfileImageResponse_ChangeOwnProfileImageResponseErrorType;
+    Error?: AuthError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageResponse.
  * Use `create(ChangeOwnProfileImageResponseSchema)` to create a new message.
  */
 export declare const ChangeOwnProfileImageResponseSchema: GenMessage<ChangeOwnProfileImageResponse>;
-/**
- * @generated from enum IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageResponse.ChangeOwnProfileImageResponseErrorType
- */
-export declare enum ChangeOwnProfileImageResponse_ChangeOwnProfileImageResponseErrorType {
-    /**
-     * @generated from enum value: NoError = 0;
-     */
-    NoError = 0,
-    /**
-     * @generated from enum value: UnknownError = -1;
-     */
-    UnknownError = -1,
-    /**
-     * @generated from enum value: BadFormat = 1;
-     */
-    BadFormat = 1
-}
-/**
- * Describes the enum IT.WebServices.Fragments.Authentication.ChangeOwnProfileImageResponse.ChangeOwnProfileImageResponseErrorType.
- */
-export declare const ChangeOwnProfileImageResponse_ChangeOwnProfileImageResponseErrorTypeSchema: GenEnum<ChangeOwnProfileImageResponse_ChangeOwnProfileImageResponseErrorType>;
 /**
  * @generated from message IT.WebServices.Fragments.Authentication.CreateUserRequest
  */
@@ -380,9 +284,9 @@ export declare const DisableEnableOtherUserRequestSchema: GenMessage<DisableEnab
  */
 export type DisableEnableOtherUserResponse = Message<"IT.WebServices.Fragments.Authentication.DisableEnableOtherUserResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authentication.DisableEnableOtherUserResponse.DisableEnableOtherUserResponseErrorType Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authentication.AuthError Error = 10;
      */
-    Error: DisableEnableOtherUserResponse_DisableEnableOtherUserResponseErrorType;
+    Error?: AuthError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authentication.DisableEnableOtherUserResponse.

package/dist/protos/Authorization/Events/AdminEventInterface_pb.d.ts

@@ -3,7 +3,7 @@ import type { Timestamp } from "@bufbuild/protobuf/wkt";
 import type { EventRecord, EventRecurrenceRule, EventVenue } from "./EventRecord_pb";
 import type { EventTicketRecord } from "./EventTicketRecord_pb";
 import type { EventTicketClass } from "./TicketClassRecord_pb";
-import type { EventError, TicketError } from "./EventError_pb";
+import type { EventError } from "./EventError_pb";
 import type { Pagination } from "../../CommonTypes_pb";
 import type { Message } from "@bufbuild/protobuf";
 /**
@@ -469,9 +469,9 @@ export declare const AdminCancelOtherTicketRequestSchema: GenMessage<AdminCancel
  */
 export type AdminCancelOtherTicketResponse = Message<"IT.WebServices.Fragments.Authorization.Events.AdminCancelOtherTicketResponse"> & {
     /**
-     * @generated from field: IT.WebServices.Fragments.Authorization.Events.TicketError Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authorization.Events.EventError Error = 1;
      */
-    Error?: TicketError;
+    Error?: EventError;
 };
 /**
  * Describes the message IT.WebServices.Fragments.Authorization.Events.AdminCancelOtherTicketResponse.
@@ -519,9 +519,9 @@ export type AdminReserveEventTicketForUserResponse = Message<"IT.WebServices.Fra
     /**
      * Error information if reservation failed
      *
-     * @generated from field: IT.WebServices.Fragments.Authorization.Events.TicketError Error = 1;
+     * @generated from field: IT.WebServices.Fragments.Authorization.Events.EventError Error = 1;
      */
-    Error?: TicketError;
+    Error?: EventError;
     /**
      * List of reserved tickets if successful
      *