@crosspost/types 0.2.0 → 0.2.2

package/dist/index.js

@@ -88,14 +88,9 @@ var ResponseMetaSchema = z3.object({
     reset: z3.number().int().positive().describe("Unix timestamp (seconds)")
   }).optional().describe("Rate limit information if applicable"),
   pagination: z3.object({
-    page: z3.number().int().positive().optional(),
-    perPage: z3.number().int().positive().optional(),
-    total: z3.number().int().nonnegative().optional(),
     limit: z3.number().int().nonnegative().optional(),
     offset: z3.number().int().nonnegative().optional(),
-    totalPages: z3.number().int().nonnegative().optional(),
-    nextCursor: z3.string().optional(),
-    prevCursor: z3.string().optional()
+    total: z3.number().int().nonnegative().optional()
   }).optional().describe("Pagination information if applicable")
 });
 var SuccessDetailSchema = z3.object({
@@ -207,12 +202,12 @@ var NearAuthorizationRequestSchema = z5.object({
   // No additional parameters needed, as the NEAR account ID is extracted from the signature
 }).describe("NEAR authorization request");
 var NearAuthorizationResponseSchema = z5.object({
-  nearAccount: z5.string().describe("NEAR account ID"),
-  authorized: z5.boolean().describe("Whether the account is authorized")
+  signerId: z5.string().describe("NEAR account ID"),
+  isAuthorized: z5.boolean().describe("Whether the account is authorized")
 }).describe("NEAR authorization response");
 var NearAuthorizationStatusResponseSchema = z5.object({
-  nearAccount: z5.string().describe("NEAR account ID"),
-  authorized: z5.boolean().describe("Whether the account is authorized"),
+  signerId: z5.string().describe("NEAR account ID"),
+  isAuthorized: z5.boolean().describe("Whether the account is authorized"),
   authorizedAt: z5.string().optional().describe("When the account was authorized")
 }).describe("NEAR authorization status response");
 
@@ -434,6 +429,16 @@ var EndpointRateLimitResponseSchema = z7.object({
 
 // src/activity.ts
 import { z as z8 } from "zod";
+var ActivityType = /* @__PURE__ */ ((ActivityType2) => {
+  ActivityType2["POST"] = "post";
+  ActivityType2["REPOST"] = "repost";
+  ActivityType2["REPLY"] = "reply";
+  ActivityType2["QUOTE"] = "quote";
+  ActivityType2["LIKE"] = "like";
+  ActivityType2["UNLIKE"] = "unlike";
+  ActivityType2["DELETE"] = "delete";
+  return ActivityType2;
+})(ActivityType || {});
 var TimePeriod = /* @__PURE__ */ ((TimePeriod2) => {
   TimePeriod2["ALL"] = "all";
   TimePeriod2["YEARLY"] = "year";
@@ -442,13 +447,45 @@ var TimePeriod = /* @__PURE__ */ ((TimePeriod2) => {
   TimePeriod2["DAILY"] = "day";
   return TimePeriod2;
 })(TimePeriod || {});
-var ActivityLeaderboardQuerySchema = z8.object({
-  timeframe: z8.nativeEnum(TimePeriod).optional().describe(
-    "Timeframe for the leaderboard"
-  ),
+var FilterSchema = z8.object({
+  platforms: z8.string().optional().transform((val) => {
+    if (!val) return void 0;
+    return val.split(",").map((p) => p.trim()).map((p) => {
+      try {
+        return Platform[p.toUpperCase()];
+      } catch (_e) {
+        return p;
+      }
+    });
+  }).pipe(
+    z8.array(z8.nativeEnum(Platform)).optional()
+  ).describe("Filter by platforms (comma-separated list, optional)"),
+  types: z8.string().optional().transform((val) => {
+    if (!val) return void 0;
+    return val.split(",").map((t) => t.trim()).map((t) => {
+      try {
+        return ActivityType[t.toUpperCase()];
+      } catch (_e) {
+        return t;
+      }
+    });
+  }).pipe(
+    z8.array(z8.nativeEnum(ActivityType)).optional()
+  ).describe("Filter by activity types (comma-separated list, optional)"),
+  timeframe: z8.nativeEnum(TimePeriod).optional().transform((val) => {
+    if (!val) return "all" /* ALL */;
+    return val;
+  }).describe(
+    "Timeframe for filtering (optional)"
+  )
+}).describe("Filter parameters");
+var PaginationSchema = z8.object({
   limit: z8.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z8.number().min(1).max(100).optional()).describe("Maximum number of results to return (1-100)"),
   offset: z8.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z8.number().min(0).optional()).describe("Offset for pagination")
-}).describe("Activity leaderboard query");
+}).describe("Pagination parameters");
+var ActivityLeaderboardQuerySchema = z8.object({
+  filter: FilterSchema.optional()
+}).describe("Account leaderboard query").merge(PaginationSchema);
 var AccountActivityEntrySchema = z8.object({
   signerId: z8.string().describe("NEAR account ID"),
   totalPosts: z8.number().describe("Total number of posts"),
@@ -458,22 +495,21 @@ var AccountActivityEntrySchema = z8.object({
   totalQuotes: z8.number().describe("Total number of quote posts"),
   totalScore: z8.number().describe("Total activity score"),
   rank: z8.number().describe("Rank on the leaderboard"),
-  lastActive: z8.string().datetime().describe("Timestamp of last activity")
+  lastActive: z8.string().datetime().describe("Timestamp of last activity"),
+  firstPostTimestamp: z8.string().datetime().describe("Timestamp of the first post")
 }).describe("Account activity entry");
 var ActivityLeaderboardResponseSchema = z8.object({
   timeframe: z8.nativeEnum(TimePeriod).describe("Timeframe for the leaderboard"),
   entries: z8.array(AccountActivityEntrySchema).describe("Leaderboard entries"),
   generatedAt: z8.string().datetime().describe("Timestamp when the leaderboard was generated"),
-  platform: PlatformSchema.optional().describe("Platform filter (if applied)")
+  platforms: z8.array(PlatformSchema).optional().describe("Platform filters (if applied)")
 });
 var AccountActivityParamsSchema = z8.object({
   signerId: z8.string().describe("NEAR account ID")
 }).describe("Account activity params");
 var AccountActivityQuerySchema = z8.object({
-  timeframe: z8.nativeEnum(TimePeriod).optional().describe(
-    "Timeframe for the activity"
-  )
-}).describe("Account activity query");
+  filter: FilterSchema.optional()
+}).describe("Account activity query").merge(PaginationSchema);
 var PlatformActivitySchema = z8.object({
   platform: PlatformSchema,
   posts: z8.number().describe("Number of posts on this platform"),
@@ -501,17 +537,13 @@ var AccountPostsParamsSchema = z8.object({
   signerId: z8.string().describe("NEAR account ID")
 }).describe("Account posts params");
 var AccountPostsQuerySchema = z8.object({
-  platform: z8.string().optional().describe("Filter by platform (optional)"),
-  limit: z8.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z8.number().min(1).max(100).optional()).describe("Maximum number of results to return (1-100)"),
-  offset: z8.string().optional().transform((val) => val ? parseInt(val, 10) : void 0).pipe(z8.number().min(0).optional()).describe("Offset for pagination"),
-  type: z8.enum(["post", "repost", "reply", "quote", "like", "all"]).optional().describe(
-    "Filter by post type (optional)"
-  )
-}).describe("Account posts query");
+  filter: FilterSchema.optional()
+}).describe("Account posts query").merge(PaginationSchema);
 var AccountPostSchema = z8.object({
   id: z8.string().describe("Post ID"),
   platform: PlatformSchema,
-  type: z8.enum(["post", "repost", "reply", "quote", "like"]).describe("Type of post"),
+  userId: z8.string().describe("User ID on the platform"),
+  type: z8.nativeEnum(ActivityType).describe("Type of post"),
   content: z8.string().optional().describe("Post content (if available)"),
   url: z8.string().url().optional().describe("URL to the post on the platform (if available)"),
   createdAt: z8.string().datetime().describe("Timestamp when the post was created"),
@@ -527,10 +559,8 @@ var AccountPostSchema = z8.object({
 var AccountPostsResponseSchema = z8.object({
   signerId: z8.string().describe("NEAR account ID"),
   posts: z8.array(AccountPostSchema).describe("List of posts"),
-  platform: z8.string().optional().describe("Platform filter (if applied)"),
-  type: z8.enum(["post", "repost", "reply", "quote", "like", "all"]).optional().describe(
-    "Post type filter (if applied)"
-  )
+  platforms: z8.array(z8.string()).optional().describe("Platform filters (if applied)"),
+  types: z8.array(z8.string()).optional().describe("Post type filters (if applied)")
 });
 export {
   AccountActivityEntrySchema,
@@ -540,6 +570,7 @@ export {
   AccountPostsParamsSchema,
   AccountPostsQuerySchema,
   ActivityLeaderboardQuerySchema,
+  ActivityType,
   AllRateLimitsResponseSchema,
   ApiErrorCode,
   ApiErrorCodeSchema,
@@ -561,6 +592,7 @@ export {
   DeleteResultSchema,
   EndpointRateLimitResponseSchema,
   ErrorDetailSchema,
+  FilterSchema,
   HealthStatusSchema,
   LikePostRequestSchema,
   LikePostResponseSchema,
@@ -573,6 +605,7 @@ export {
   NearAuthorizationResponseSchema,
   NearAuthorizationStatusResponseSchema,
   NearUnauthorizationResponseSchema,
+  PaginationSchema,
   Platform,
   PlatformActivitySchema,
   PlatformParamSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crosspost/types",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Shared type definitions for Crosspost API",
   "type": "module",
   "main": "dist/index.cjs",

package/src/activity.ts

@@ -1,5 +1,15 @@
 import { z } from 'zod';
-import { PlatformSchema } from './common.ts';
+import { Platform, PlatformSchema } from './common.ts';
+
+export enum ActivityType {
+  POST = 'post',
+  REPOST = 'repost',
+  REPLY = 'reply',
+  QUOTE = 'quote',
+  LIKE = 'like',
+  UNLIKE = 'unlike',
+  DELETE = 'delete',
+}
 
 export enum TimePeriod {
   ALL = 'all',
@@ -9,10 +19,57 @@ export enum TimePeriod {
   DAILY = 'day',
 }
 
-export const ActivityLeaderboardQuerySchema = z.object({
-  timeframe: z.nativeEnum(TimePeriod).optional().describe(
-    'Timeframe for the leaderboard',
+/**
+ * Schema for filtering by platform, activity type, and timeframe
+ * Handles comma-separated lists for platforms and types
+ */
+export const FilterSchema = z.object({
+  platforms: z.string().optional()
+    .transform((val) => {
+      if (!val) return undefined;
+      return val.split(',')
+        .map((p) => p.trim())
+        .map((p) => {
+          try {
+            return Platform[p.toUpperCase() as keyof typeof Platform];
+          } catch (_e) {
+            return p;
+          }
+        });
+    })
+    .pipe(
+      z.array(z.nativeEnum(Platform)).optional(),
+    )
+    .describe('Filter by platforms (comma-separated list, optional)'),
+  types: z.string().optional()
+    .transform((val) => {
+      if (!val) return undefined;
+      return val.split(',')
+        .map((t) => t.trim())
+        .map((t) => {
+          try {
+            return ActivityType[t.toUpperCase() as keyof typeof ActivityType];
+          } catch (_e) {
+            return t;
+          }
+        });
+    })
+    .pipe(
+      z.array(z.nativeEnum(ActivityType)).optional(),
+    )
+    .describe('Filter by activity types (comma-separated list, optional)'),
+  timeframe: z.nativeEnum(TimePeriod).optional().transform((val) => {
+    if (!val) return TimePeriod.ALL;
+    return val;
+  }).describe(
+    'Timeframe for filtering (optional)',
   ),
+}).describe('Filter parameters');
+
+/**
+ * Common pagination schema used across queries
+ */
+export const PaginationSchema = z.object({
   limit: z.string().optional()
     .transform((val) => val ? parseInt(val, 10) : undefined)
     .pipe(z.number().min(1).max(100).optional())
@@ -21,7 +78,14 @@ export const ActivityLeaderboardQuerySchema = z.object({
     .transform((val) => val ? parseInt(val, 10) : undefined)
     .pipe(z.number().min(0).optional())
     .describe('Offset for pagination'),
-}).describe('Activity leaderboard query');
+}).describe('Pagination parameters');
+
+/**
+ * Query schema for leaderboard endpoints
+ */
+export const ActivityLeaderboardQuerySchema = z.object({
+  filter: FilterSchema.optional(),
+}).describe('Account leaderboard query').merge(PaginationSchema);
 
 export const AccountActivityEntrySchema = z.object({
   signerId: z.string().describe('NEAR account ID'),
@@ -33,24 +97,26 @@ export const AccountActivityEntrySchema = z.object({
   totalScore: z.number().describe('Total activity score'),
   rank: z.number().describe('Rank on the leaderboard'),
   lastActive: z.string().datetime().describe('Timestamp of last activity'),
+  firstPostTimestamp: z.string().datetime().describe('Timestamp of the first post'),
 }).describe('Account activity entry');
 
 const ActivityLeaderboardResponseSchema = z.object({
   timeframe: z.nativeEnum(TimePeriod).describe('Timeframe for the leaderboard'),
   entries: z.array(AccountActivityEntrySchema).describe('Leaderboard entries'),
   generatedAt: z.string().datetime().describe('Timestamp when the leaderboard was generated'),
-  platform: PlatformSchema.optional().describe('Platform filter (if applied)'),
+  platforms: z.array(PlatformSchema).optional().describe('Platform filters (if applied)'),
 });
 
 export const AccountActivityParamsSchema = z.object({
   signerId: z.string().describe('NEAR account ID'),
 }).describe('Account activity params');
 
+/**
+ * Query schema for account activity endpoints
+ */
 export const AccountActivityQuerySchema = z.object({
-  timeframe: z.nativeEnum(TimePeriod).optional().describe(
-    'Timeframe for the activity',
-  ),
-}).describe('Account activity query');
+  filter: FilterSchema.optional(),
+}).describe('Account activity query').merge(PaginationSchema);
 
 export const PlatformActivitySchema = z.object({
   platform: PlatformSchema,
@@ -81,25 +147,18 @@ export const AccountPostsParamsSchema = z.object({
   signerId: z.string().describe('NEAR account ID'),
 }).describe('Account posts params');
 
+/**
+ * Query schema for account posts endpoints
+ */
 export const AccountPostsQuerySchema = z.object({
-  platform: z.string().optional().describe('Filter by platform (optional)'),
-  limit: z.string().optional()
-    .transform((val) => val ? parseInt(val, 10) : undefined)
-    .pipe(z.number().min(1).max(100).optional())
-    .describe('Maximum number of results to return (1-100)'),
-  offset: z.string().optional()
-    .transform((val) => val ? parseInt(val, 10) : undefined)
-    .pipe(z.number().min(0).optional())
-    .describe('Offset for pagination'),
-  type: z.enum(['post', 'repost', 'reply', 'quote', 'like', 'all']).optional().describe(
-    'Filter by post type (optional)',
-  ),
-}).describe('Account posts query');
+  filter: FilterSchema.optional(),
+}).describe('Account posts query').merge(PaginationSchema);
 
 export const AccountPostSchema = z.object({
   id: z.string().describe('Post ID'),
   platform: PlatformSchema,
-  type: z.enum(['post', 'repost', 'reply', 'quote', 'like']).describe('Type of post'),
+  userId: z.string().describe('User ID on the platform'),
+  type: z.nativeEnum(ActivityType).describe('Type of post'),
   content: z.string().optional().describe('Post content (if available)'),
   url: z.string().url().optional().describe('URL to the post on the platform (if available)'),
   createdAt: z.string().datetime().describe('Timestamp when the post was created'),
@@ -116,10 +175,8 @@ export const AccountPostSchema = z.object({
 const AccountPostsResponseSchema = z.object({
   signerId: z.string().describe('NEAR account ID'),
   posts: z.array(AccountPostSchema).describe('List of posts'),
-  platform: z.string().optional().describe('Platform filter (if applied)'),
-  type: z.enum(['post', 'repost', 'reply', 'quote', 'like', 'all']).optional().describe(
-    'Post type filter (if applied)',
-  ),
+  platforms: z.array(z.string()).optional().describe('Platform filters (if applied)'),
+  types: z.array(z.string()).optional().describe('Post type filters (if applied)'),
 });
 
 /**
@@ -147,6 +204,7 @@ export interface PostRecord {
   p: string; // platform
   t: number; // timestamp
   u: string; // userId
+  ty: string; // activity type ('post', 'like', 'repost', etc.)
 }
 
 export type ActivityLeaderboardQuery = z.infer<typeof ActivityLeaderboardQuerySchema>;
@@ -160,3 +218,4 @@ export type AccountPostsParams = z.infer<typeof AccountPostsParamsSchema>;
 export type AccountPostsQuery = z.infer<typeof AccountPostsQuerySchema>;
 export type AccountPost = z.infer<typeof AccountPostSchema>;
 export type AccountPostsResponse = z.infer<typeof AccountPostsResponseSchema>;
+export type Filter = z.infer<typeof FilterSchema>;

package/src/auth.ts

@@ -84,13 +84,13 @@ export const NearAuthorizationRequestSchema = z.object({
 }).describe('NEAR authorization request');
 
 export const NearAuthorizationResponseSchema = z.object({
-  nearAccount: z.string().describe('NEAR account ID'),
-  authorized: z.boolean().describe('Whether the account is authorized'),
+  signerId: z.string().describe('NEAR account ID'),
+  isAuthorized: z.boolean().describe('Whether the account is authorized'),
 }).describe('NEAR authorization response');
 
 export const NearAuthorizationStatusResponseSchema = z.object({
-  nearAccount: z.string().describe('NEAR account ID'),
-  authorized: z.boolean().describe('Whether the account is authorized'),
+  signerId: z.string().describe('NEAR account ID'),
+  isAuthorized: z.boolean().describe('Whether the account is authorized'),
   authorizedAt: z.string().optional().describe('When the account was authorized'),
 }).describe('NEAR authorization status response');
 

package/src/response.ts

@@ -10,14 +10,9 @@ export const ResponseMetaSchema = z.object({
     reset: z.number().int().positive().describe('Unix timestamp (seconds)'),
   }).optional().describe('Rate limit information if applicable'),
   pagination: z.object({
-    page: z.number().int().positive().optional(),
-    perPage: z.number().int().positive().optional(),
-    total: z.number().int().nonnegative().optional(),
     limit: z.number().int().nonnegative().optional(),
     offset: z.number().int().nonnegative().optional(),
-    totalPages: z.number().int().nonnegative().optional(),
-    nextCursor: z.string().optional(),
-    prevCursor: z.string().optional(),
+    total: z.number().int().nonnegative().optional(),
   }).optional().describe('Pagination information if applicable'),
 });
 
@@ -48,7 +43,7 @@ export const MultiStatusDataSchema = z.object({
 
 export interface ApiResponse<T> {
   success: boolean;
-  data?: T | MultiStatusData | null; // Allow null for success without data, updated type name
+  data?: T | null; // Allow null for success without data, updated type name
   errors?: ErrorDetail[] | null; // Allow null for success
   meta: ResponseMeta; // Mandatory, holds request id
 }