@nativesquare/upwork 0.1.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.
Files changed (69) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +160 -0
  3. package/dist/client/_generated/_ignore.d.ts +1 -0
  4. package/dist/client/_generated/_ignore.d.ts.map +1 -0
  5. package/dist/client/_generated/_ignore.js +3 -0
  6. package/dist/client/_generated/_ignore.js.map +1 -0
  7. package/dist/client/index.d.ts +40 -0
  8. package/dist/client/index.d.ts.map +1 -0
  9. package/dist/client/index.js +82 -0
  10. package/dist/client/index.js.map +1 -0
  11. package/dist/client/types.d.ts +34 -0
  12. package/dist/client/types.d.ts.map +1 -0
  13. package/dist/client/types.js +3 -0
  14. package/dist/client/types.js.map +1 -0
  15. package/dist/component/_generated/api.d.ts +38 -0
  16. package/dist/component/_generated/api.d.ts.map +1 -0
  17. package/dist/component/_generated/api.js +31 -0
  18. package/dist/component/_generated/api.js.map +1 -0
  19. package/dist/component/_generated/component.d.ts +84 -0
  20. package/dist/component/_generated/component.d.ts.map +1 -0
  21. package/dist/component/_generated/component.js +11 -0
  22. package/dist/component/_generated/component.js.map +1 -0
  23. package/dist/component/_generated/dataModel.d.ts +46 -0
  24. package/dist/component/_generated/dataModel.d.ts.map +1 -0
  25. package/dist/component/_generated/dataModel.js +11 -0
  26. package/dist/component/_generated/dataModel.js.map +1 -0
  27. package/dist/component/_generated/server.d.ts +121 -0
  28. package/dist/component/_generated/server.d.ts.map +1 -0
  29. package/dist/component/_generated/server.js +78 -0
  30. package/dist/component/_generated/server.js.map +1 -0
  31. package/dist/component/convex.config.d.ts +3 -0
  32. package/dist/component/convex.config.d.ts.map +1 -0
  33. package/dist/component/convex.config.js +3 -0
  34. package/dist/component/convex.config.js.map +1 -0
  35. package/dist/component/crons.d.ts +3 -0
  36. package/dist/component/crons.d.ts.map +1 -0
  37. package/dist/component/crons.js +6 -0
  38. package/dist/component/crons.js.map +1 -0
  39. package/dist/component/private.d.ts +36 -0
  40. package/dist/component/private.d.ts.map +1 -0
  41. package/dist/component/private.js +99 -0
  42. package/dist/component/private.js.map +1 -0
  43. package/dist/component/public.d.ts +68 -0
  44. package/dist/component/public.d.ts.map +1 -0
  45. package/dist/component/public.js +241 -0
  46. package/dist/component/public.js.map +1 -0
  47. package/dist/component/schema.d.ts +59 -0
  48. package/dist/component/schema.d.ts.map +1 -0
  49. package/dist/component/schema.js +30 -0
  50. package/dist/component/schema.js.map +1 -0
  51. package/dist/react/index.d.ts +2 -0
  52. package/dist/react/index.d.ts.map +1 -0
  53. package/dist/react/index.js +6 -0
  54. package/dist/react/index.js.map +1 -0
  55. package/package.json +108 -0
  56. package/src/client/_generated/_ignore.ts +1 -0
  57. package/src/client/index.ts +131 -0
  58. package/src/client/types.ts +50 -0
  59. package/src/component/_generated/api.ts +54 -0
  60. package/src/component/_generated/component.ts +121 -0
  61. package/src/component/_generated/dataModel.ts +60 -0
  62. package/src/component/_generated/server.ts +156 -0
  63. package/src/component/convex.config.ts +3 -0
  64. package/src/component/crons.ts +13 -0
  65. package/src/component/private.ts +108 -0
  66. package/src/component/public.ts +315 -0
  67. package/src/component/schema.ts +31 -0
  68. package/src/react/index.ts +7 -0
  69. package/src/test.ts +18 -0
@@ -0,0 +1,241 @@
1
+ import { query, action } from "./_generated/server.js";
2
+ import { api } from "./_generated/api.js";
3
+ import { v } from "convex/values";
4
+ function buildJobPostingsQuery(opts) {
5
+ const filterArg = opts.searchQuery
6
+ ? `marketPlaceJobFilter: $marketPlaceJobFilter,`
7
+ : "";
8
+ const sortField = opts.sortField ?? "RECENCY";
9
+ const variableDefs = opts.searchQuery
10
+ ? `($marketPlaceJobFilter: MarketplaceJobPostingsSearchFilter)`
11
+ : "";
12
+ const variables = {};
13
+ if (opts.searchQuery) {
14
+ variables.marketPlaceJobFilter = {
15
+ searchTerm_eq: { andTerms_all: opts.searchQuery },
16
+ };
17
+ }
18
+ const query = `
19
+ query ${variableDefs} {
20
+ marketplaceJobPostingsSearch(
21
+ ${filterArg}
22
+ searchType: USER_JOBS_SEARCH
23
+ sortAttributes: { field: ${sortField} }
24
+ ) {
25
+ totalCount
26
+ edges {
27
+ node {
28
+ id
29
+ title
30
+ description
31
+ category { id name }
32
+ subcategory { id name }
33
+ skills { name }
34
+ experienceLevel
35
+ duration
36
+ budget { amount currency }
37
+ createdDateTime
38
+ publishedDateTime
39
+ client { totalHires companyName }
40
+ }
41
+ }
42
+ pageInfo { hasNextPage endCursor }
43
+ }
44
+ }`;
45
+ return { query, variables };
46
+ }
47
+ export const refreshAccessToken = action({
48
+ args: {
49
+ clientId: v.string(),
50
+ clientSecret: v.string(),
51
+ baseUrl: v.string(),
52
+ },
53
+ handler: async (ctx, args) => {
54
+ const tokens = await ctx.runQuery(api.private.getTokens, {});
55
+ if (!tokens) {
56
+ throw new Error("No stored tokens found. Complete OAuth authorization first.");
57
+ }
58
+ const tokenUrl = `${args.baseUrl}/api/v3/oauth2/token`;
59
+ const response = await fetch(tokenUrl, {
60
+ method: "POST",
61
+ headers: {
62
+ "Content-Type": "application/x-www-form-urlencoded",
63
+ Accept: "application/json",
64
+ },
65
+ body: new URLSearchParams({
66
+ grant_type: "refresh_token",
67
+ client_id: args.clientId,
68
+ client_secret: args.clientSecret,
69
+ refresh_token: tokens.refreshToken,
70
+ }).toString(),
71
+ });
72
+ if (!response.ok) {
73
+ const text = await response.text();
74
+ throw new Error(`Token refresh failed (${response.status}): ${text}`);
75
+ }
76
+ const data = await response.json();
77
+ const expiresAt = Date.now() + (data.expires_in ?? 86400) * 1000;
78
+ await ctx.runMutation(api.private.storeTokens, {
79
+ accessToken: data.access_token,
80
+ refreshToken: data.refresh_token ?? tokens.refreshToken,
81
+ expiresAt,
82
+ tokenType: data.token_type ?? "Bearer",
83
+ });
84
+ },
85
+ });
86
+ export const exchangeAuthCode = action({
87
+ args: {
88
+ clientId: v.string(),
89
+ clientSecret: v.string(),
90
+ code: v.string(),
91
+ redirectUri: v.string(),
92
+ baseUrl: v.string(),
93
+ },
94
+ handler: async (ctx, args) => {
95
+ const tokenUrl = `${args.baseUrl}/api/v3/oauth2/token`;
96
+ const body = new URLSearchParams({
97
+ grant_type: "authorization_code",
98
+ client_id: args.clientId,
99
+ client_secret: args.clientSecret,
100
+ code: args.code,
101
+ redirect_uri: args.redirectUri,
102
+ }).toString();
103
+ console.log("[exchangeAuthCode] POST", tokenUrl);
104
+ console.log("[exchangeAuthCode] redirect_uri:", args.redirectUri);
105
+ console.log("[exchangeAuthCode] client_id:", args.clientId);
106
+ console.log("[exchangeAuthCode] code:", args.code);
107
+ const response = await fetch(tokenUrl, {
108
+ method: "POST",
109
+ headers: {
110
+ "Content-Type": "application/x-www-form-urlencoded",
111
+ Accept: "application/json",
112
+ },
113
+ body,
114
+ });
115
+ if (!response.ok) {
116
+ const text = await response.text();
117
+ throw new Error(`OAuth token exchange failed (${response.status}): ${text}`);
118
+ }
119
+ const data = await response.json();
120
+ const expiresAt = Date.now() + (data.expires_in ?? 86400) * 1000;
121
+ await ctx.runMutation(api.private.storeTokens, {
122
+ accessToken: data.access_token,
123
+ refreshToken: data.refresh_token,
124
+ expiresAt,
125
+ tokenType: data.token_type ?? "Bearer",
126
+ });
127
+ },
128
+ });
129
+ export const searchJobPostings = action({
130
+ args: {
131
+ clientId: v.string(),
132
+ clientSecret: v.string(),
133
+ baseUrl: v.string(),
134
+ searchQuery: v.optional(v.string()),
135
+ sortField: v.optional(v.string()),
136
+ },
137
+ handler: async (ctx, args) => {
138
+ let tokens = await ctx.runQuery(api.private.getTokens, {});
139
+ if (!tokens) {
140
+ throw new Error("Not connected to Upwork. Complete OAuth authorization first.");
141
+ }
142
+ if (tokens.expiresAt < Date.now()) {
143
+ await ctx.runAction(api.public.refreshAccessToken, {
144
+ clientId: args.clientId,
145
+ clientSecret: args.clientSecret,
146
+ baseUrl: args.baseUrl,
147
+ });
148
+ tokens = await ctx.runQuery(api.private.getTokens, {});
149
+ if (!tokens) {
150
+ throw new Error("Failed to refresh token.");
151
+ }
152
+ }
153
+ const graphqlUrl = `${args.baseUrl}/graphql`;
154
+ const { query, variables } = buildJobPostingsQuery({
155
+ searchQuery: args.searchQuery,
156
+ sortField: args.sortField,
157
+ });
158
+ const response = await fetch(graphqlUrl, {
159
+ method: "POST",
160
+ headers: {
161
+ "Content-Type": "application/json",
162
+ Authorization: `Bearer ${tokens.accessToken}`,
163
+ },
164
+ body: JSON.stringify({ query, variables }),
165
+ });
166
+ if (!response.ok) {
167
+ const text = await response.text();
168
+ throw new Error(`Upwork GraphQL request failed (${response.status}): ${text}`);
169
+ }
170
+ const result = await response.json();
171
+ if (result.errors?.length) {
172
+ throw new Error(`Upwork GraphQL errors: ${result.errors.map((e) => e.message).join(", ")}`);
173
+ }
174
+ const connection = result.data?.marketplaceJobPostingsSearch;
175
+ if (!connection) {
176
+ return { totalCount: 0, postings: [], hasNextPage: false };
177
+ }
178
+ const postings = (connection.edges ?? []).map((edge) => {
179
+ const node = edge.node;
180
+ const budget = node.budget;
181
+ const client = node.client;
182
+ const category = node.category;
183
+ const subcategory = node.subcategory;
184
+ const skills = node.skills ?? [];
185
+ return {
186
+ upworkId: String(node.id),
187
+ title: String(node.title ?? ""),
188
+ description: String(node.description ?? ""),
189
+ category: category?.name ?? undefined,
190
+ subcategory: subcategory?.name ?? undefined,
191
+ skills: skills.map((s) => ({ name: s.name })),
192
+ experienceLevel: String(node.experienceLevel ?? ""),
193
+ duration: node.duration != null ? String(node.duration) : undefined,
194
+ budgetAmount: budget?.amount != null ? String(budget.amount) : undefined,
195
+ budgetCurrency: budget?.currency != null ? String(budget.currency) : undefined,
196
+ createdDateTime: String(node.createdDateTime ?? ""),
197
+ publishedDateTime: String(node.publishedDateTime ?? ""),
198
+ clientTotalHires: client?.totalHires ?? undefined,
199
+ clientCompanyName: client?.companyName ?? undefined,
200
+ };
201
+ });
202
+ if (postings.length > 0) {
203
+ await ctx.runMutation(api.private.upsertJobPostings, { postings });
204
+ }
205
+ return {
206
+ totalCount: connection.totalCount ?? 0,
207
+ postings,
208
+ hasNextPage: connection.pageInfo?.hasNextPage ?? false,
209
+ };
210
+ },
211
+ });
212
+ const TWENTY_THREE_HOURS_MS = 23 * 60 * 60 * 1000;
213
+ export const listJobPostings = query({
214
+ args: {
215
+ limit: v.optional(v.number()),
216
+ },
217
+ handler: async (ctx, args) => {
218
+ const limit = args.limit ?? 50;
219
+ const cutoff = Date.now() - TWENTY_THREE_HOURS_MS;
220
+ const postings = await ctx.db
221
+ .query("jobPostings")
222
+ .withIndex("byCachedAt", (q) => q.gte("cachedAt", cutoff))
223
+ .order("desc")
224
+ .take(limit);
225
+ return postings;
226
+ },
227
+ });
228
+ export const getAuthStatus = query({
229
+ args: {},
230
+ handler: async (ctx) => {
231
+ const tokens = await ctx.db.query("oauthTokens").first();
232
+ if (!tokens) {
233
+ return "disconnected";
234
+ }
235
+ if (tokens.expiresAt < Date.now()) {
236
+ return "expired";
237
+ }
238
+ return "connected";
239
+ },
240
+ });
241
+ //# sourceMappingURL=public.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/component/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,SAAS,qBAAqB,CAAC,IAG9B;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW;QAChC,CAAC,CAAC,8CAA8C;QAChD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAE9C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW;QACnC,CAAC,CAAC,6DAA6D;QAC/D,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,SAAS,CAAC,oBAAoB,GAAG;YAC/B,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE;SAClD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG;QACR,YAAY;;MAEd,SAAS;;+BAEgB,SAAS;;;;;;;;;;;;;;;;;;;;;EAqBtC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC;AAyBD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,sBAAsB,CAAC;QAEvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,mCAAmC;gBACnD,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,eAAe,CAAC;gBACxB,UAAU,EAAE,eAAe;gBAC3B,SAAS,EAAE,IAAI,CAAC,QAAQ;gBACxB,aAAa,EAAE,IAAI,CAAC,YAAY;gBAChC,aAAa,EAAE,MAAM,CAAC,YAAY;aACnC,CAAC,CAAC,QAAQ,EAAE;SACd,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;QAEjE,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE;YAC7C,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,YAAY,EAAE,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,YAAY;YACvD,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ;SACvC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;IACrC,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;KACpB;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAiB,EAAE;QAC1C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,sBAAsB,CAAC;QAEvD,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;YAC/B,UAAU,EAAE,oBAAoB;YAChC,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,WAAW;SAC/B,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEd,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,mCAAmC;gBACnD,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;QAEjE,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE;YAC7C,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,SAAS;YACT,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,QAAQ;SACvC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;IACtC,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAClC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAyB,EAAE;QAClD,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE;gBACjD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,OAAO,UAAU,CAAC;QAE7C,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC;YACjD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,CAAC,WAAW,EAAE;aAC9C;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,MAAM,GAOR,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE1B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,4BAA4B,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,QAAQ,GAAoB,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,IAAI,EAAE,EAAE;YACP,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAuD,CAAC;YAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,MAGZ,CAAC;YACT,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAoC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,WAAuC,CAAC;YACjE,MAAM,MAAM,GAAI,IAAI,CAAC,MAAkC,IAAI,EAAE,CAAC;YAE9D,OAAO;gBACL,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC/B,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC3C,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI,SAAS;gBACrC,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI,SAAS;gBAC3C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7C,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;gBACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;gBACnE,YAAY,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxE,cAAc,EAAE,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9E,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC;gBACnD,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC;gBACvD,gBAAgB,EAAE,MAAM,EAAE,UAAU,IAAI,SAAS;gBACjD,iBAAiB,EAAE,MAAM,EAAE,WAAW,IAAI,SAAS;aACpD,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO;YACL,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,CAAC;YACtC,QAAQ;YACR,WAAW,EAAE,UAAU,CAAC,QAAQ,EAAE,WAAW,IAAI,KAAK;SACvD,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;IACnC,IAAI,EAAE;QACJ,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC9B;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,EAAE;aAC1B,KAAK,CAAC,aAAa,CAAC;aACpB,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;aACzD,KAAK,CAAC,MAAM,CAAC;aACb,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;IACjC,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,cAAuB,CAAC;QACjC,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,OAAO,SAAkB,CAAC;QAC5B,CAAC;QACD,OAAO,WAAoB,CAAC;IAC9B,CAAC;CACF,CAAC,CAAC"}
@@ -0,0 +1,59 @@
1
+ declare const _default: import("convex/server").SchemaDefinition<{
2
+ oauthTokens: import("convex/server").TableDefinition<import("convex/values").VObject<{
3
+ accessToken: string;
4
+ refreshToken: string;
5
+ expiresAt: number;
6
+ tokenType: string;
7
+ }, {
8
+ accessToken: import("convex/values").VString<string, "required">;
9
+ refreshToken: import("convex/values").VString<string, "required">;
10
+ expiresAt: import("convex/values").VFloat64<number, "required">;
11
+ tokenType: import("convex/values").VString<string, "required">;
12
+ }, "required", "accessToken" | "refreshToken" | "expiresAt" | "tokenType">, {}, {}, {}>;
13
+ jobPostings: import("convex/server").TableDefinition<import("convex/values").VObject<{
14
+ category?: string | undefined;
15
+ subcategory?: string | undefined;
16
+ duration?: string | undefined;
17
+ budgetAmount?: string | undefined;
18
+ budgetCurrency?: string | undefined;
19
+ clientTotalHires?: number | undefined;
20
+ clientCompanyName?: string | undefined;
21
+ upworkId: string;
22
+ title: string;
23
+ description: string;
24
+ skills: {
25
+ name: string;
26
+ }[];
27
+ experienceLevel: string;
28
+ createdDateTime: string;
29
+ publishedDateTime: string;
30
+ cachedAt: number;
31
+ }, {
32
+ upworkId: import("convex/values").VString<string, "required">;
33
+ title: import("convex/values").VString<string, "required">;
34
+ description: import("convex/values").VString<string, "required">;
35
+ category: import("convex/values").VString<string | undefined, "optional">;
36
+ subcategory: import("convex/values").VString<string | undefined, "optional">;
37
+ skills: import("convex/values").VArray<{
38
+ name: string;
39
+ }[], import("convex/values").VObject<{
40
+ name: string;
41
+ }, {
42
+ name: import("convex/values").VString<string, "required">;
43
+ }, "required", "name">, "required">;
44
+ experienceLevel: import("convex/values").VString<string, "required">;
45
+ duration: import("convex/values").VString<string | undefined, "optional">;
46
+ budgetAmount: import("convex/values").VString<string | undefined, "optional">;
47
+ budgetCurrency: import("convex/values").VString<string | undefined, "optional">;
48
+ createdDateTime: import("convex/values").VString<string, "required">;
49
+ publishedDateTime: import("convex/values").VString<string, "required">;
50
+ clientTotalHires: import("convex/values").VFloat64<number | undefined, "optional">;
51
+ clientCompanyName: import("convex/values").VString<string | undefined, "optional">;
52
+ cachedAt: import("convex/values").VFloat64<number, "required">;
53
+ }, "required", "upworkId" | "title" | "description" | "category" | "subcategory" | "skills" | "experienceLevel" | "duration" | "budgetAmount" | "budgetCurrency" | "createdDateTime" | "publishedDateTime" | "clientTotalHires" | "clientCompanyName" | "cachedAt">, {
54
+ byUpworkId: ["upworkId", "_creationTime"];
55
+ byCachedAt: ["cachedAt", "_creationTime"];
56
+ }, {}, {}>;
57
+ }, true>;
58
+ export default _default;
59
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBA2BG"}
@@ -0,0 +1,30 @@
1
+ import { defineSchema, defineTable } from "convex/server";
2
+ import { v } from "convex/values";
3
+ export default defineSchema({
4
+ oauthTokens: defineTable({
5
+ accessToken: v.string(),
6
+ refreshToken: v.string(),
7
+ expiresAt: v.number(),
8
+ tokenType: v.string(),
9
+ }),
10
+ jobPostings: defineTable({
11
+ upworkId: v.string(),
12
+ title: v.string(),
13
+ description: v.string(),
14
+ category: v.optional(v.string()),
15
+ subcategory: v.optional(v.string()),
16
+ skills: v.array(v.object({ name: v.string() })),
17
+ experienceLevel: v.string(),
18
+ duration: v.optional(v.string()),
19
+ budgetAmount: v.optional(v.string()),
20
+ budgetCurrency: v.optional(v.string()),
21
+ createdDateTime: v.string(),
22
+ publishedDateTime: v.string(),
23
+ clientTotalHires: v.optional(v.number()),
24
+ clientCompanyName: v.optional(v.string()),
25
+ cachedAt: v.number(),
26
+ })
27
+ .index("byUpworkId", ["upworkId"])
28
+ .index("byCachedAt", ["cachedAt"]),
29
+ });
30
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,YAAY,CAAC;IAC1B,WAAW,EAAE,WAAW,CAAC;QACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;KACtB,CAAC;IAEF,WAAW,EAAE,WAAW,CAAC;QACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAChC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACpC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;QAC3B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC7B,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;SACC,KAAK,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;SACjC,KAAK,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,CAAC;CACrC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare const useMyComponent: () => {};
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,UAE1B,CAAC"}
@@ -0,0 +1,6 @@
1
+ "use client";
2
+ // This is where React components / hooks go.
3
+ export const useMyComponent = () => {
4
+ return {};
5
+ };
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,6CAA6C;AAE7C,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,108 @@
1
+ {
2
+ "name": "@nativesquare/upwork",
3
+ "description": "An Upwork component for Convex.",
4
+ "repository": "github:NativeSquare/upwork",
5
+ "homepage": "https://github.com/NativeSquare/upwork#readme",
6
+ "bugs": {
7
+ "url": "https://github.com/NativeSquare/upwork/issues"
8
+ },
9
+ "version": "0.1.0",
10
+ "license": "Apache-2.0",
11
+ "keywords": [
12
+ "convex",
13
+ "component"
14
+ ],
15
+ "type": "module",
16
+ "scripts": {
17
+ "dev": "run-p -r dev:*",
18
+ "dev:backend": "convex dev --typecheck-components",
19
+ "dev:frontend": "cd example && vite --clearScreen false",
20
+ "dev:build": "chokidar \"tsconfig*.json\" \"src/**/*.ts\" -i \"**/*.test.ts\" -c \"npm run build:codegen\" --initial",
21
+ "predev": "path-exists .env.local dist || (npm run build && convex dev --once)",
22
+ "build": "tsc --project ./tsconfig.build.json",
23
+ "build:codegen": "npx convex codegen --component-dir ./src/component && npm run build",
24
+ "build:clean": "npx rimraf dist *.tsbuildinfo && npm run build:codegen",
25
+ "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
26
+ "lint": "eslint .",
27
+ "all": "run-p -r dev:* test:watch",
28
+ "test": "vitest run --typecheck",
29
+ "test:watch": "vitest --typecheck --clearScreen false",
30
+ "test:debug": "vitest --inspect-brk --no-file-parallelism",
31
+ "test:coverage": "vitest run --coverage --coverage.reporter=text",
32
+ "preversion": "npm ci && npm run build:clean && run-p test lint typecheck",
33
+ "prepublishOnly": "npm whoami || npm login",
34
+ "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
35
+ "release": "npm version patch && npm publish && git push --follow-tags",
36
+ "version": "vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
37
+ },
38
+ "files": [
39
+ "dist",
40
+ "src"
41
+ ],
42
+ "exports": {
43
+ "./package.json": "./package.json",
44
+ ".": {
45
+ "types": "./dist/client/index.d.ts",
46
+ "default": "./dist/client/index.js"
47
+ },
48
+ "./react": {
49
+ "types": "./dist/react/index.d.ts",
50
+ "default": "./dist/react/index.js"
51
+ },
52
+ "./test": "./src/test.ts",
53
+ "./_generated/component.js": {
54
+ "types": "./dist/component/_generated/component.d.ts"
55
+ },
56
+ "./_generated/component": {
57
+ "types": "./dist/component/_generated/component.d.ts"
58
+ },
59
+ "./convex.config.js": {
60
+ "types": "./dist/component/convex.config.d.ts",
61
+ "default": "./dist/component/convex.config.js"
62
+ },
63
+ "./convex.config": {
64
+ "types": "./dist/component/convex.config.d.ts",
65
+ "default": "./dist/component/convex.config.js"
66
+ }
67
+ },
68
+ "peerDependencies": {
69
+ "convex": "^1.31.7",
70
+ "react": "^18.3.1 || ^19.0.0"
71
+ },
72
+ "devDependencies": {
73
+ "@convex-dev/eslint-plugin": "^1.1.1",
74
+ "@edge-runtime/vm": "^5.0.0",
75
+ "@eslint/eslintrc": "^3.3.3",
76
+ "@eslint/js": "9.39.2",
77
+ "@types/node": "^24.10.11",
78
+ "@types/react": "^19.2.13",
79
+ "@types/react-dom": "^19.2.3",
80
+ "@vitejs/plugin-react": "^5.1.3",
81
+ "chokidar-cli": "3.0.0",
82
+ "convex": "1.31.7",
83
+ "convex-test": "0.0.41",
84
+ "eslint": "9.39.2",
85
+ "eslint-plugin-react": "^7.37.5",
86
+ "eslint-plugin-react-hooks": "^7.0.1",
87
+ "eslint-plugin-react-refresh": "^0.5.0",
88
+ "globals": "^17.3.0",
89
+ "npm-run-all2": "8.0.4",
90
+ "path-exists-cli": "2.0.0",
91
+ "pkg-pr-new": "^0.0.63",
92
+ "prettier": "3.8.1",
93
+ "react": "^19.2.4",
94
+ "react-dom": "^19.2.4",
95
+ "typescript": "5.9.3",
96
+ "typescript-eslint": "8.54.0",
97
+ "vite": "7.3.1",
98
+ "vitest": "4.0.18"
99
+ },
100
+ "types": "./dist/client/index.d.ts",
101
+ "module": "./dist/client/index.js",
102
+ "pnpm": {
103
+ "onlyBuiltDependencies": [
104
+ "esbuild",
105
+ "@tailwindcss/oxide"
106
+ ]
107
+ }
108
+ }
@@ -0,0 +1 @@
1
+ // This is only here so convex-test can detect a _generated folder
@@ -0,0 +1,131 @@
1
+ import type { ComponentApi } from "../component/_generated/component.js";
2
+ import type { ActionCtx, QueryCtx, JobPosting, SearchResult, AuthStatus } from "./types.js";
3
+ import { DEFAULT_BASE_URL, CALLBACK_PATH } from "./types.js";
4
+ import type { HttpRouter } from "convex/server";
5
+ import { httpActionGeneric } from "convex/server";
6
+
7
+ export type UpworkComponent = ComponentApi;
8
+
9
+ export class Upwork {
10
+ constructor(public component: UpworkComponent) {}
11
+
12
+ getAuthorizationUrl(opts: {
13
+ clientId: string;
14
+ siteUrl: string;
15
+ baseUrl?: string;
16
+ }): string {
17
+ const base = opts.baseUrl ?? DEFAULT_BASE_URL;
18
+ const redirectUri = `${opts.siteUrl}${CALLBACK_PATH}`;
19
+ const params = new URLSearchParams({
20
+ response_type: "code",
21
+ client_id: opts.clientId,
22
+ redirect_uri: redirectUri,
23
+ });
24
+ return `${base}/ab/account-security/oauth2/authorize?${params.toString()}`;
25
+ }
26
+
27
+ async exchangeAuthCode(
28
+ ctx: ActionCtx,
29
+ opts: {
30
+ clientId: string;
31
+ clientSecret: string;
32
+ code: string;
33
+ siteUrl: string;
34
+ baseUrl?: string;
35
+ },
36
+ ): Promise<void> {
37
+ const redirectUri = `${opts.siteUrl}${CALLBACK_PATH}`;
38
+ await ctx.runAction(this.component.public.exchangeAuthCode, {
39
+ clientId: opts.clientId,
40
+ clientSecret: opts.clientSecret,
41
+ code: opts.code,
42
+ redirectUri,
43
+ baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
44
+ });
45
+ }
46
+
47
+ async searchJobPostings(
48
+ ctx: ActionCtx,
49
+ opts: {
50
+ clientId: string;
51
+ clientSecret: string;
52
+ searchQuery?: string;
53
+ sortField?: string;
54
+ baseUrl?: string;
55
+ },
56
+ ): Promise<SearchResult> {
57
+ return await ctx.runAction(this.component.public.searchJobPostings, {
58
+ clientId: opts.clientId,
59
+ clientSecret: opts.clientSecret,
60
+ baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
61
+ searchQuery: opts.searchQuery,
62
+ sortField: opts.sortField,
63
+ });
64
+ }
65
+
66
+ async listJobPostings(
67
+ ctx: QueryCtx,
68
+ opts?: { limit?: number },
69
+ ): Promise<JobPosting[]> {
70
+ return await ctx.runQuery(this.component.public.listJobPostings, {
71
+ limit: opts?.limit,
72
+ });
73
+ }
74
+
75
+ async getAuthStatus(ctx: QueryCtx): Promise<AuthStatus> {
76
+ return await ctx.runQuery(this.component.public.getAuthStatus, {});
77
+ }
78
+ }
79
+
80
+ export function registerRoutes(
81
+ http: HttpRouter,
82
+ component: UpworkComponent,
83
+ opts: {
84
+ clientId: string;
85
+ clientSecret: string;
86
+ baseUrl?: string;
87
+ onSuccess?: string;
88
+ },
89
+ ) {
90
+ const baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
91
+
92
+ http.route({
93
+ path: CALLBACK_PATH,
94
+ method: "GET",
95
+ handler: httpActionGeneric(async (ctx, request) => {
96
+ const url = new URL(request.url);
97
+ const code = url.searchParams.get("code");
98
+
99
+ if (!code) {
100
+ return new Response("Missing authorization code", { status: 400 });
101
+ }
102
+
103
+ const redirectUri = `${url.origin}${url.pathname}`;
104
+
105
+ try {
106
+ await ctx.runAction(component.public.exchangeAuthCode, {
107
+ clientId: opts.clientId,
108
+ clientSecret: opts.clientSecret,
109
+ code,
110
+ redirectUri,
111
+ baseUrl,
112
+ });
113
+ } catch (error) {
114
+ const message = error instanceof Error ? error.message : "Unknown error";
115
+ return new Response(`OAuth callback failed: ${message}`, { status: 500 });
116
+ }
117
+
118
+ if (opts.onSuccess) {
119
+ return new Response(null, {
120
+ status: 302,
121
+ headers: { Location: opts.onSuccess },
122
+ });
123
+ }
124
+
125
+ return new Response("Successfully connected to Upwork!", { status: 200 });
126
+ }),
127
+ });
128
+ }
129
+
130
+ export { DEFAULT_BASE_URL, CALLBACK_PATH } from "./types.js";
131
+ export type { JobPosting, SearchResult, AuthStatus } from "./types.js";
@@ -0,0 +1,50 @@
1
+ import type {
2
+ GenericActionCtx,
3
+ GenericMutationCtx,
4
+ GenericQueryCtx,
5
+ GenericDataModel,
6
+ } from "convex/server";
7
+
8
+ export type QueryCtx = Pick<GenericQueryCtx<GenericDataModel>, "runQuery">;
9
+
10
+ export type MutationCtx = Pick<
11
+ GenericMutationCtx<GenericDataModel>,
12
+ "runQuery" | "runMutation"
13
+ >;
14
+
15
+ export type ActionCtx = Pick<
16
+ GenericActionCtx<GenericDataModel>,
17
+ "runQuery" | "runMutation" | "runAction"
18
+ >;
19
+
20
+ export type JobPosting = {
21
+ _id: string;
22
+ _creationTime: number;
23
+ upworkId: string;
24
+ title: string;
25
+ description: string;
26
+ category?: string;
27
+ subcategory?: string;
28
+ skills: Array<{ name: string }>;
29
+ experienceLevel: string;
30
+ duration?: string;
31
+ budgetAmount?: string;
32
+ budgetCurrency?: string;
33
+ createdDateTime: string;
34
+ publishedDateTime: string;
35
+ clientTotalHires?: number;
36
+ clientCompanyName?: string;
37
+ cachedAt: number;
38
+ };
39
+
40
+ export type SearchResult = {
41
+ totalCount: number;
42
+ postings: Omit<JobPosting, "_id" | "_creationTime">[];
43
+ hasNextPage: boolean;
44
+ };
45
+
46
+ export type AuthStatus = "connected" | "disconnected" | "expired";
47
+
48
+ export const DEFAULT_BASE_URL = "https://upwork-mock-server.onrender.com";
49
+
50
+ export const CALLBACK_PATH = "/upwork/callback";