scavio 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1158,6 +1158,12 @@ interface LinkedInPersonOptions {
1158
1158
  url?: string;
1159
1159
  [key: string]: unknown;
1160
1160
  }
1161
+ interface LinkedInPersonPostsRequest extends LinkedInPersonOptions {
1162
+ /** Which feed: the member's own posts (default), posts they commented on, or posts they reacted to. */
1163
+ type?: "posts" | "comments" | "reactions";
1164
+ /** Opaque cursor from a previous response's next_cursor. */
1165
+ cursor?: string;
1166
+ }
1161
1167
  /** A company reference: a universal name (slug), or a full company URL. */
1162
1168
  interface LinkedInCompanyOptions {
1163
1169
  /** Company universal name (slug), e.g. "microsoft". */
@@ -1166,17 +1172,23 @@ interface LinkedInCompanyOptions {
1166
1172
  url?: string;
1167
1173
  [key: string]: unknown;
1168
1174
  }
1175
+ interface LinkedInCompanyPostsRequest extends LinkedInCompanyOptions {
1176
+ /** Opaque cursor from a previous response's next_cursor. */
1177
+ cursor?: string;
1178
+ }
1169
1179
  /** @deprecated Use {@link LinkedInPersonOptions}. */
1170
1180
  type LinkedInPersonRefOptions = LinkedInPersonOptions;
1171
- /** @deprecated Use {@link LinkedInPersonOptions}. */
1172
- type LinkedInPersonPostsOptions = LinkedInPersonOptions;
1173
- /** @deprecated Use {@link LinkedInCompanyOptions}. */
1174
- type LinkedInCompanyPostsOptions = LinkedInCompanyOptions;
1181
+ /** @deprecated Use {@link LinkedInPersonPostsRequest}. */
1182
+ type LinkedInPersonPostsOptions = LinkedInPersonPostsRequest;
1183
+ /** @deprecated Use {@link LinkedInCompanyPostsRequest}. */
1184
+ type LinkedInCompanyPostsOptions = LinkedInCompanyPostsRequest;
1175
1185
  interface LinkedInSearchJobsOptions {
1176
1186
  /** Search keyword. */
1177
1187
  search: string;
1178
1188
  /** Geographic filter; omit to search everywhere. */
1179
1189
  location?: string;
1190
+ /** Opaque cursor from a previous response's next_cursor. */
1191
+ cursor?: string;
1180
1192
  [key: string]: unknown;
1181
1193
  }
1182
1194
  interface LinkedInJobOptions {
@@ -1194,7 +1206,7 @@ interface LinkedInPostOptions {
1194
1206
  [key: string]: unknown;
1195
1207
  }
1196
1208
  interface LinkedInPostCommentsOptions extends LinkedInPostOptions {
1197
- /** 1-based page number, 10 comments per page. */
1209
+ /** 1-based page number. Page size varies, so page until a page comes back empty. */
1198
1210
  page?: number;
1199
1211
  }
1200
1212
  /** @deprecated Retired upstream; always returns HTTP 410. */
@@ -1229,19 +1241,25 @@ declare class LinkedInNamespace {
1229
1241
  person(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1230
1242
  /** The about-only slice of the profile payload. */
1231
1243
  personAbout(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1232
- /** Recent posts, up to 50. Upstream exposes no further pages. */
1233
- personPosts(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1244
+ /**
1245
+ * A member's posts, or the posts they commented on or reacted to via `type`.
1246
+ * 50 per page; pass the previous response's `next_cursor` to advance.
1247
+ */
1248
+ personPosts(options: LinkedInPersonPostsRequest): Promise<Record<string, unknown>>;
1234
1249
  /** Company profile, including locations and featured employees. */
1235
1250
  company(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
1236
- /** Recent company posts, up to 50. Upstream exposes no further pages. */
1237
- companyPosts(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
1238
- /** Job search. Upstream rotates its result set, so repeat calls differ. */
1251
+ /** Recent company posts, 50 per page; advance with `next_cursor`. */
1252
+ companyPosts(options: LinkedInCompanyPostsRequest): Promise<Record<string, unknown>>;
1253
+ /**
1254
+ * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
1255
+ * result set, so pages overlap slightly - dedupe by job id.
1256
+ */
1239
1257
  searchJobs(options: LinkedInSearchJobsOptions): Promise<Record<string, unknown>>;
1240
1258
  /** Full detail for one job listing, including the hiring company. */
1241
1259
  job(options: LinkedInJobOptions): Promise<Record<string, unknown>>;
1242
1260
  /** Full detail for one post, including its top visible comments. */
1243
1261
  post(options: LinkedInPostOptions): Promise<Record<string, unknown>>;
1244
- /** Comments with their replies, 10 per page. */
1262
+ /** Comments with their replies. Page size varies - keep paging until empty. */
1245
1263
  postComments(options: LinkedInPostCommentsOptions): Promise<Record<string, unknown>>;
1246
1264
  /**
1247
1265
  * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
package/dist/index.d.ts CHANGED
@@ -1158,6 +1158,12 @@ interface LinkedInPersonOptions {
1158
1158
  url?: string;
1159
1159
  [key: string]: unknown;
1160
1160
  }
1161
+ interface LinkedInPersonPostsRequest extends LinkedInPersonOptions {
1162
+ /** Which feed: the member's own posts (default), posts they commented on, or posts they reacted to. */
1163
+ type?: "posts" | "comments" | "reactions";
1164
+ /** Opaque cursor from a previous response's next_cursor. */
1165
+ cursor?: string;
1166
+ }
1161
1167
  /** A company reference: a universal name (slug), or a full company URL. */
1162
1168
  interface LinkedInCompanyOptions {
1163
1169
  /** Company universal name (slug), e.g. "microsoft". */
@@ -1166,17 +1172,23 @@ interface LinkedInCompanyOptions {
1166
1172
  url?: string;
1167
1173
  [key: string]: unknown;
1168
1174
  }
1175
+ interface LinkedInCompanyPostsRequest extends LinkedInCompanyOptions {
1176
+ /** Opaque cursor from a previous response's next_cursor. */
1177
+ cursor?: string;
1178
+ }
1169
1179
  /** @deprecated Use {@link LinkedInPersonOptions}. */
1170
1180
  type LinkedInPersonRefOptions = LinkedInPersonOptions;
1171
- /** @deprecated Use {@link LinkedInPersonOptions}. */
1172
- type LinkedInPersonPostsOptions = LinkedInPersonOptions;
1173
- /** @deprecated Use {@link LinkedInCompanyOptions}. */
1174
- type LinkedInCompanyPostsOptions = LinkedInCompanyOptions;
1181
+ /** @deprecated Use {@link LinkedInPersonPostsRequest}. */
1182
+ type LinkedInPersonPostsOptions = LinkedInPersonPostsRequest;
1183
+ /** @deprecated Use {@link LinkedInCompanyPostsRequest}. */
1184
+ type LinkedInCompanyPostsOptions = LinkedInCompanyPostsRequest;
1175
1185
  interface LinkedInSearchJobsOptions {
1176
1186
  /** Search keyword. */
1177
1187
  search: string;
1178
1188
  /** Geographic filter; omit to search everywhere. */
1179
1189
  location?: string;
1190
+ /** Opaque cursor from a previous response's next_cursor. */
1191
+ cursor?: string;
1180
1192
  [key: string]: unknown;
1181
1193
  }
1182
1194
  interface LinkedInJobOptions {
@@ -1194,7 +1206,7 @@ interface LinkedInPostOptions {
1194
1206
  [key: string]: unknown;
1195
1207
  }
1196
1208
  interface LinkedInPostCommentsOptions extends LinkedInPostOptions {
1197
- /** 1-based page number, 10 comments per page. */
1209
+ /** 1-based page number. Page size varies, so page until a page comes back empty. */
1198
1210
  page?: number;
1199
1211
  }
1200
1212
  /** @deprecated Retired upstream; always returns HTTP 410. */
@@ -1229,19 +1241,25 @@ declare class LinkedInNamespace {
1229
1241
  person(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1230
1242
  /** The about-only slice of the profile payload. */
1231
1243
  personAbout(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1232
- /** Recent posts, up to 50. Upstream exposes no further pages. */
1233
- personPosts(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
1244
+ /**
1245
+ * A member's posts, or the posts they commented on or reacted to via `type`.
1246
+ * 50 per page; pass the previous response's `next_cursor` to advance.
1247
+ */
1248
+ personPosts(options: LinkedInPersonPostsRequest): Promise<Record<string, unknown>>;
1234
1249
  /** Company profile, including locations and featured employees. */
1235
1250
  company(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
1236
- /** Recent company posts, up to 50. Upstream exposes no further pages. */
1237
- companyPosts(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
1238
- /** Job search. Upstream rotates its result set, so repeat calls differ. */
1251
+ /** Recent company posts, 50 per page; advance with `next_cursor`. */
1252
+ companyPosts(options: LinkedInCompanyPostsRequest): Promise<Record<string, unknown>>;
1253
+ /**
1254
+ * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
1255
+ * result set, so pages overlap slightly - dedupe by job id.
1256
+ */
1239
1257
  searchJobs(options: LinkedInSearchJobsOptions): Promise<Record<string, unknown>>;
1240
1258
  /** Full detail for one job listing, including the hiring company. */
1241
1259
  job(options: LinkedInJobOptions): Promise<Record<string, unknown>>;
1242
1260
  /** Full detail for one post, including its top visible comments. */
1243
1261
  post(options: LinkedInPostOptions): Promise<Record<string, unknown>>;
1244
- /** Comments with their replies, 10 per page. */
1262
+ /** Comments with their replies. Page size varies - keep paging until empty. */
1245
1263
  postComments(options: LinkedInPostCommentsOptions): Promise<Record<string, unknown>>;
1246
1264
  /**
1247
1265
  * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
package/dist/index.js CHANGED
@@ -728,7 +728,10 @@ var LinkedInNamespace = class {
728
728
  async personAbout(options) {
729
729
  return this.client._post("/api/v1/linkedin/person/about", options);
730
730
  }
731
- /** Recent posts, up to 50. Upstream exposes no further pages. */
731
+ /**
732
+ * A member's posts, or the posts they commented on or reacted to via `type`.
733
+ * 50 per page; pass the previous response's `next_cursor` to advance.
734
+ */
732
735
  async personPosts(options) {
733
736
  return this.client._post("/api/v1/linkedin/person/posts", options);
734
737
  }
@@ -736,11 +739,14 @@ var LinkedInNamespace = class {
736
739
  async company(options) {
737
740
  return this.client._post("/api/v1/linkedin/company", options);
738
741
  }
739
- /** Recent company posts, up to 50. Upstream exposes no further pages. */
742
+ /** Recent company posts, 50 per page; advance with `next_cursor`. */
740
743
  async companyPosts(options) {
741
744
  return this.client._post("/api/v1/linkedin/company/posts", options);
742
745
  }
743
- /** Job search. Upstream rotates its result set, so repeat calls differ. */
746
+ /**
747
+ * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
748
+ * result set, so pages overlap slightly - dedupe by job id.
749
+ */
744
750
  async searchJobs(options) {
745
751
  return this.client._post("/api/v1/linkedin/search/jobs", options);
746
752
  }
@@ -752,7 +758,7 @@ var LinkedInNamespace = class {
752
758
  async post(options) {
753
759
  return this.client._post("/api/v1/linkedin/post", options);
754
760
  }
755
- /** Comments with their replies, 10 per page. */
761
+ /** Comments with their replies. Page size varies - keep paging until empty. */
756
762
  async postComments(options) {
757
763
  return this.client._post("/api/v1/linkedin/post/comments", options);
758
764
  }