@bitbitpress/client 1.1.4 → 1.2.3

package/README.md

@@ -47,8 +47,6 @@ More details can also be found in your control room's API docs @ https://your-co
   - [updateProfile](#updateprofile)
   - [recommendations](#recommendations)
   - [report](#report)
-  - [createSubmission](#createsubmission)
-  - [submissions](#submissions)
   - [submit](#submit)
   - [submissionState](#submissionstate)
   - [submissionFeed](#submissionfeed)
@@ -175,7 +173,7 @@ console.log('Access token:', tokenResponse.accessToken);
 
 #### profile
 
-Get user profile information, including interest tags, suggested topics, job title, and company.
+Get user profile information, including interest tags, suggested topics, and custom attributes.
 
 ```typescript
 client.user.profile(): Promise<ProfileResponse>
@@ -186,8 +184,7 @@ client.user.profile(): Promise<ProfileResponse>
 - `Promise<ProfileResponse>`: Response containing:
   - `interestTags: string[]`: User-picked interest tags
   - `suggestedInterestTags: string[]`: Suggested interest topics for the user
-  - `jobTitle?: string`: User's job title
-  - `company?: string`: User's company or organization
+  - `customAttributes?: Record<string, unknown>`: Customer-defined profile attributes (shape governed by the deployment's active app-user profile schema)
 
 ##### Example
 
@@ -195,8 +192,7 @@ client.user.profile(): Promise<ProfileResponse>
 const profile = await client.user.profile();
 console.log('Interest tags:', profile.interestTags);
 console.log('Suggested topics:', profile.suggestedInterestTags);
-console.log('Job title:', profile.jobTitle);
-console.log('Company:', profile.company);
+console.log('Custom attributes:', profile.customAttributes);
 ```
 
 ##### Throws
@@ -207,7 +203,7 @@ console.log('Company:', profile.company);
 
 #### updateProfile
 
-Update user profile. Supports full interest tag replace via `interestTags`, add/remove via `addInterestTags` and `removeInterestTags`, and `jobTitle` / `company` updates. Pass an empty string to clear `jobTitle` or `company`.
+Update user profile. Supports full interest tag replace via `interestTags`, add/remove via `addInterestTags` and `removeInterestTags`, and `customAttributes` (validated against the deployment's active app-user profile schema).
 
 ```typescript
 client.user.updateProfile(options: ProfileUpdateRequest): Promise<ProfileResponse>
@@ -218,8 +214,7 @@ client.user.updateProfile(options: ProfileUpdateRequest): Promise<ProfileRespons
 - `options.interestTags` (optional): Full replace — set the complete list of interest tags
 - `options.addInterestTags` (optional): Add these tags (ignored if `interestTags` is provided)
 - `options.removeInterestTags` (optional): Remove these tags (ignored if `interestTags` is provided)
-- `options.jobTitle` (optional): Set the user's job title; pass `''` to clear
-- `options.company` (optional): Set the user's company or organization; pass `''` to clear
+- `options.customAttributes` (optional): Customer-defined profile attributes; validated against the deployment's active app-user profile schema before persisting
 
 ##### Returns
 
@@ -230,8 +225,7 @@ client.user.updateProfile(options: ProfileUpdateRequest): Promise<ProfileRespons
 ```typescript
 await client.user.updateProfile({
   interestTags: ['Technology', 'Science'],
-  jobTitle: 'Editor',
-  company: 'Daily Planet',
+  customAttributes: { jobTitle: 'Editor', company: 'Daily Planet' },
 });
 // Or add/remove:
 await client.user.updateProfile({
@@ -347,90 +341,6 @@ await client.user.report({
 
 ---
 
-#### createSubmission
-
-Create a structured user submission and optional presigned file upload URLs.
-
-```typescript
-client.user.createSubmission(options: CreateUserSubmissionRequest): Promise<CreateUserSubmissionResponse>
-```
-
-##### Parameters
-
-- `options.keyName` (required): User submission schema key name
-- `options.data` (required): Structured submission data
-- `options.files` (optional): File descriptors for presigned uploads, each with `field`, `contentType`, and optional `fileName`
-
-##### Returns
-
-- `Promise<CreateUserSubmissionResponse>`: Created submission and any presigned upload URLs
-
-##### Example
-
-```typescript
-const result = await client.user.createSubmission({
-  keyName: 'reader-tip',
-  data: {
-    title: 'Transit delay',
-    description: 'The downtown train is delayed.',
-  },
-  files: [
-    {
-      field: 'photo',
-      contentType: 'image/jpeg',
-      fileName: 'platform.jpg',
-    },
-  ],
-});
-
-console.log('Submission:', result.submission);
-console.log('Upload URLs:', result.uploads);
-```
-
-##### Throws
-
-- `Error`: If the request fails or no data is returned
-
----
-
-#### submissions
-
-List live submissions for a user submission schema.
-
-```typescript
-client.user.submissions(
-  keyName: string,
-  options?: ListUserSubmissionsRequest,
-): Promise<ListUserSubmissionsResponse>
-```
-
-##### Parameters
-
-- `keyName` (required): User submission schema key name
-- `options.first` (optional): Maximum number of submissions to return
-- `options.after` (optional): Cursor from the previous response
-
-##### Returns
-
-- `Promise<ListUserSubmissionsResponse>`: Response containing `items` and a nullable `cursor`
-
-##### Example
-
-```typescript
-const result = await client.user.submissions('reader-tip', {
-  first: 20,
-});
-
-console.log('Submissions:', result.items);
-console.log('Next cursor:', result.cursor);
-```
-
-##### Throws
-
-- `Error`: If the request fails or no data is returned
-
----
-
 #### submit
 
 Submit content (a poll vote or a contest entry) tied to a synthesis output. One submission per user per piece — re-submitting overwrites the prior one. Get `synthesisOutputId` from the synthesize response (`result.synthesisOutputId`).
@@ -937,8 +847,7 @@ type RecommendationsRequest = {
 type ProfileResponse = {
   interestTags: string[];
   suggestedInterestTags: string[];
-  jobTitle?: string;
-  company?: string;
+  customAttributes?: Record<string, unknown>;
 }
 ```
 
@@ -949,8 +858,7 @@ type ProfileUpdateRequest = {
   interestTags?: string[];        // Full replace: set the complete list
   addInterestTags?: string[];    // Add tags (ignored if interestTags is provided)
   removeInterestTags?: string[]; // Remove tags (ignored if interestTags is provided)
-  jobTitle?: string;             // Pass empty string to clear
-  company?: string;              // Pass empty string to clear
+  customAttributes?: Record<string, unknown>; // Validated against the deployment's profile schema
 }
 ```
 
@@ -982,58 +890,6 @@ type ReportRequest = {
 type ReportResponse = unknown;
 ```
 
-#### CreateUserSubmissionRequest
-
-```typescript
-type CreateUserSubmissionRequest = {
-  keyName: string;
-  data: Record<string, unknown>;
-  files?: Array<{
-    field: string;
-    contentType: string;
-    fileName?: string;
-  }>;
-}
-```
-
-#### CreateUserSubmissionResponse
-
-```typescript
-type CreateUserSubmissionResponse = {
-  submission: {
-    id: string;
-    userSubmissionSchemaId: string;
-    userId: string;
-    state: string;
-    createdAt: string;
-    updatedAt?: string;
-  } & Record<string, unknown>;
-  uploads: Array<{
-    field: string;
-    s3Key: string;
-    uploadUrl: string;
-  }>;
-}
-```
-
-#### ListUserSubmissionsRequest
-
-```typescript
-type ListUserSubmissionsRequest = {
-  first?: number;
-  after?: string;
-}
-```
-
-#### ListUserSubmissionsResponse
-
-```typescript
-type ListUserSubmissionsResponse = {
-  cursor: string | null;
-  items: Array<Record<string, unknown>>;
-}
-```
-
 #### SignalRequest
 
 ```typescript