target-supabase-sdk 0.1.7 → 0.1.9

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 (171) hide show
  1. package/README.md +8 -6
  2. package/dist/auth/auth.api.d.ts.map +1 -1
  3. package/dist/auth/auth.api.js +8 -7
  4. package/dist/auth/auth.api.js.map +1 -1
  5. package/dist/command/command.api.d.ts +43 -0
  6. package/dist/command/command.api.d.ts.map +1 -0
  7. package/dist/command/command.api.js +58 -0
  8. package/dist/command/command.api.js.map +1 -0
  9. package/dist/command/command.interface.d.ts +14 -0
  10. package/dist/command/command.interface.d.ts.map +1 -0
  11. package/dist/command/command.interface.js +9 -0
  12. package/dist/command/command.interface.js.map +1 -0
  13. package/dist/core.api.d.ts +116 -12
  14. package/dist/core.api.d.ts.map +1 -1
  15. package/dist/core.api.js +289 -103
  16. package/dist/core.api.js.map +1 -1
  17. package/dist/core.interface.d.ts +2 -1
  18. package/dist/core.interface.d.ts.map +1 -1
  19. package/dist/core.interface.js +1 -1
  20. package/dist/core.interface.js.map +1 -1
  21. package/dist/core.utils.d.ts +0 -2
  22. package/dist/core.utils.d.ts.map +1 -1
  23. package/dist/core.utils.js +0 -5
  24. package/dist/core.utils.js.map +1 -1
  25. package/dist/file/file-manager.d.ts +1 -1
  26. package/dist/file/file-manager.d.ts.map +1 -1
  27. package/dist/file/file-manager.js +1 -1
  28. package/dist/file/file-manager.js.map +1 -1
  29. package/dist/file-list/file-list.api.js +1 -1
  30. package/dist/file-list/file-list.api.js.map +1 -1
  31. package/dist/index.d.ts +12 -1
  32. package/dist/index.d.ts.map +1 -1
  33. package/dist/index.js +11 -1
  34. package/dist/index.js.map +1 -1
  35. package/dist/list/list.interface.d.ts +2 -2
  36. package/dist/list/list.interface.d.ts.map +1 -1
  37. package/dist/node/node-manager.d.ts +48 -0
  38. package/dist/node/node-manager.d.ts.map +1 -0
  39. package/dist/node/node-manager.js +619 -0
  40. package/dist/node/node-manager.js.map +1 -0
  41. package/dist/node/node-task.preset.d.ts +1 -0
  42. package/dist/node/node-task.preset.d.ts.map +1 -0
  43. package/dist/node/node-task.preset.js +14 -0
  44. package/dist/node/node-task.preset.js.map +1 -0
  45. package/dist/node/node.api.d.ts +68 -0
  46. package/dist/node/node.api.d.ts.map +1 -0
  47. package/dist/node/node.api.js +100 -0
  48. package/dist/node/node.api.js.map +1 -0
  49. package/dist/node/node.interface.d.ts +35 -0
  50. package/dist/node/node.interface.d.ts.map +1 -0
  51. package/dist/node/node.interface.js +19 -0
  52. package/dist/node/node.interface.js.map +1 -0
  53. package/dist/node/node.utils.d.ts +5 -0
  54. package/dist/node/node.utils.d.ts.map +1 -0
  55. package/dist/node/node.utils.js +36 -0
  56. package/dist/node/node.utils.js.map +1 -0
  57. package/dist/parcel/parcel-manager.d.ts +1 -1
  58. package/dist/parcel/parcel-manager.d.ts.map +1 -1
  59. package/dist/parcel/parcel-manager.js +1 -1
  60. package/dist/parcel/parcel-manager.js.map +1 -1
  61. package/dist/question-list/question-list.api.js +1 -1
  62. package/dist/question-list/question-list.api.js.map +1 -1
  63. package/dist/repo/repo-context.utils.d.ts +24 -0
  64. package/dist/repo/repo-context.utils.d.ts.map +1 -0
  65. package/dist/repo/repo-context.utils.js +81 -0
  66. package/dist/repo/repo-context.utils.js.map +1 -0
  67. package/dist/repo/repo-manager.d.ts +31 -0
  68. package/dist/repo/repo-manager.d.ts.map +1 -0
  69. package/dist/repo/repo-manager.js +156 -0
  70. package/dist/repo/repo-manager.js.map +1 -0
  71. package/dist/repo/repo.api.d.ts +16 -0
  72. package/dist/repo/repo.api.d.ts.map +1 -0
  73. package/dist/repo/repo.api.js +40 -0
  74. package/dist/repo/repo.api.js.map +1 -0
  75. package/dist/repo/repo.interface.d.ts +27 -0
  76. package/dist/repo/repo.interface.d.ts.map +1 -0
  77. package/dist/repo/repo.interface.js +8 -0
  78. package/dist/repo/repo.interface.js.map +1 -0
  79. package/dist/repo/repo.script-loader.d.ts +19 -0
  80. package/dist/repo/repo.script-loader.d.ts.map +1 -0
  81. package/dist/repo/repo.script-loader.js +108 -0
  82. package/dist/repo/repo.script-loader.js.map +1 -0
  83. package/dist/review/review.api.js +5 -5
  84. package/dist/review/review.api.js.map +1 -1
  85. package/dist/shared/log/create-api-logger.d.ts +17 -0
  86. package/dist/shared/log/create-api-logger.d.ts.map +1 -0
  87. package/dist/shared/log/create-api-logger.js +15 -0
  88. package/dist/shared/log/create-api-logger.js.map +1 -0
  89. package/dist/shared/log/log-manager.d.ts +114 -0
  90. package/dist/shared/log/log-manager.d.ts.map +1 -0
  91. package/dist/shared/log/log-manager.js +218 -0
  92. package/dist/shared/log/log-manager.js.map +1 -0
  93. package/dist/shared/utils/config-path.utils.d.ts +38 -0
  94. package/dist/shared/utils/config-path.utils.d.ts.map +1 -0
  95. package/dist/shared/utils/config-path.utils.js +85 -0
  96. package/dist/shared/utils/config-path.utils.js.map +1 -0
  97. package/dist/shared/utils/error.utils.d.ts +11 -0
  98. package/dist/shared/utils/error.utils.d.ts.map +1 -0
  99. package/dist/shared/utils/error.utils.js +15 -0
  100. package/dist/shared/utils/error.utils.js.map +1 -0
  101. package/dist/shared/utils/id.utils.d.ts +3 -0
  102. package/dist/shared/utils/id.utils.d.ts.map +1 -0
  103. package/dist/shared/utils/id.utils.js +5 -0
  104. package/dist/shared/utils/id.utils.js.map +1 -0
  105. package/dist/supabase.js +1 -1
  106. package/dist/supabase.js.map +1 -1
  107. package/dist/task/local-task-registry.d.ts +27 -0
  108. package/dist/task/local-task-registry.d.ts.map +1 -0
  109. package/dist/task/local-task-registry.js +153 -0
  110. package/dist/task/local-task-registry.js.map +1 -0
  111. package/dist/task/task-manager.d.ts +52 -0
  112. package/dist/task/task-manager.d.ts.map +1 -0
  113. package/dist/task/task-manager.js +217 -0
  114. package/dist/task/task-manager.js.map +1 -0
  115. package/dist/task/task-repo-context.d.ts +95 -0
  116. package/dist/task/task-repo-context.d.ts.map +1 -0
  117. package/dist/task/task-repo-context.js +12 -0
  118. package/dist/task/task-repo-context.js.map +1 -0
  119. package/dist/task/task.api.d.ts +241 -0
  120. package/dist/task/task.api.d.ts.map +1 -0
  121. package/dist/task/task.api.js +351 -0
  122. package/dist/task/task.api.js.map +1 -0
  123. package/dist/task/task.interface.d.ts +56 -0
  124. package/dist/task/task.interface.d.ts.map +1 -0
  125. package/dist/task/task.interface.js +36 -0
  126. package/dist/task/task.interface.js.map +1 -0
  127. package/dist/task/task.utils.d.ts +1 -0
  128. package/dist/task/task.utils.d.ts.map +1 -0
  129. package/dist/task/task.utils.js +2 -0
  130. package/dist/task/task.utils.js.map +1 -0
  131. package/dist/word/word.api.d.ts +5 -5
  132. package/dist/word/word.api.d.ts.map +1 -1
  133. package/dist/word/word.api.js +1 -1
  134. package/dist/word/word.api.js.map +1 -1
  135. package/package.json +10 -3
  136. package/src/auth/auth.api.ts +9 -7
  137. package/src/command/command.api.ts +88 -0
  138. package/src/command/command.interface.ts +17 -0
  139. package/src/core.api.ts +489 -133
  140. package/src/core.interface.ts +3 -1
  141. package/src/core.utils.ts +0 -6
  142. package/src/file/file-manager.ts +1 -1
  143. package/src/file-list/file-list.api.ts +1 -1
  144. package/src/index.ts +22 -1
  145. package/src/list/list.interface.ts +2 -2
  146. package/src/node/node-manager.ts +673 -0
  147. package/src/node/node-task.preset.ts +13 -0
  148. package/src/node/node.api.ts +139 -0
  149. package/src/node/node.interface.ts +40 -0
  150. package/src/node/node.utils.ts +36 -0
  151. package/src/parcel/parcel-manager.ts +1 -1
  152. package/src/question-list/question-list.api.ts +1 -1
  153. package/src/repo/repo-context.utils.ts +111 -0
  154. package/src/repo/repo-manager.ts +217 -0
  155. package/src/repo/repo.api.ts +50 -0
  156. package/src/repo/repo.interface.ts +31 -0
  157. package/src/repo/repo.script-loader.ts +140 -0
  158. package/src/review/review.api.ts +5 -5
  159. package/src/shared/log/create-api-logger.ts +25 -0
  160. package/src/shared/log/log-manager.ts +340 -0
  161. package/src/shared/utils/config-path.utils.ts +104 -0
  162. package/src/shared/utils/error.utils.ts +15 -0
  163. package/src/shared/utils/id.utils.ts +4 -0
  164. package/src/supabase.ts +1 -1
  165. package/src/task/local-task-registry.ts +195 -0
  166. package/src/task/task-manager.ts +312 -0
  167. package/src/task/task-repo-context.ts +103 -0
  168. package/src/task/task.api.ts +429 -0
  169. package/src/task/task.interface.ts +68 -0
  170. package/src/task/task.utils.ts +0 -0
  171. package/src/word/word.api.ts +6 -6
package/README.md CHANGED
@@ -30,15 +30,17 @@ cp .env.example .env.local
30
30
 
31
31
  | Variable | Required | Description |
32
32
  |----------|----------|-------------|
33
- | `VITE_SUPABASE_URL` | Yes | Main Supabase project URL |
34
- | `VITE_SUPABASE_ANON_KEY` | Yes | Main project anon (public) key |
35
- | `VITE_SUPABASE_NEED_AUTH_URL` | No | Separate auth project URL |
36
- | `VITE_SUPABASE_NEED_AUTH_ANON_KEY` | No | Separate auth project anon key |
33
+ | `SUPABASE_URL` | Yes | Main Supabase project URL |
34
+ | `SUPABASE_ANON_KEY` | Yes | Main project anon (public) key |
35
+ | `SUPABASE_NEED_AUTH_URL` | No | Separate auth project URL |
36
+ | `SUPABASE_NEED_AUTH_ANON_KEY` | No | Separate auth project anon key |
37
+
38
+ Used by `scripts/` (`pnpm worker`, `pnpm post-task`) via `.env.local`. Browser apps pass the same values to `supabase.initialize()` (e.g. `import.meta.env.VITE_SUPABASE_URL` if your bundler uses a `VITE_` prefix).
37
39
 
38
40
  ### Security
39
41
 
40
- - `VITE_*` variables are embedded in the client bundle at build time. Only use the **anon (public) key** — it is designed to be public when protected by Row Level Security (RLS).
41
- - **Never** put the `service_role` key in a `VITE_*` variable or any frontend code. Use it only in trusted server-side environments.
42
+ - Only use the **anon (public) key** in client or script env — it is designed to be public when protected by Row Level Security (RLS).
43
+ - **Never** put the `service_role` key in env files or frontend code. Use it only in trusted server-side environments.
42
44
  - Do not commit `.env` or `.env.local`. They are gitignored; only `.env.example` (placeholders) should be tracked.
43
45
  - Auth APIs return session tokens. Store them securely and never log them.
44
46
 
@@ -1 +1 @@
1
- {"version":3,"file":"auth.api.d.ts","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,YAAY,wBAA+B,eAAe;;;GAWtE,CAAC;AAGF,eAAO,MAAM,SAAS,wBAA+B,YAAY;;;;GAWhE,CAAC;AAGF,eAAO,MAAM,UAAU,uDAQtB,CAAC;AAGF,eAAO,MAAM,cAAc,2DAW1B,CAAC;AAGF,eAAO,MAAM,aAAa,UAAiB,MAAM,oDAQhD,CAAC"}
1
+ {"version":3,"file":"auth.api.d.ts","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,YAAY,wBAA+B,eAAe;;;GAWtE,CAAC;AAGF,eAAO,MAAM,SAAS,wBAA+B,YAAY;;;;GAWhE,CAAC;AAGF,eAAO,MAAM,UAAU,uDAQtB,CAAC;AAGF,eAAO,MAAM,cAAc,2DAW1B,CAAC;AAGF,eAAO,MAAM,aAAa,UAAiB,MAAM,oDAQhD,CAAC"}
@@ -1,6 +1,7 @@
1
- import { supabase } from "..";
2
- import { createResponse } from "../core.interface";
1
+ import { SupabaseInitializer } from "../supabase";
2
+ import { generateResponse } from "../core.interface";
3
3
  import { handleSupabaseError } from "../core.utils";
4
+ const supabase = SupabaseInitializer.getInstance();
4
5
  // 用户注册
5
6
  export const registerUser = async ({ email, password }) => {
6
7
  const { data, error } = await supabase.authClient.auth.signUp({
@@ -10,7 +11,7 @@ export const registerUser = async ({ email, password }) => {
10
11
  if (error) {
11
12
  handleSupabaseError("registerUser", error, "Registration failed. Please try again.");
12
13
  }
13
- return createResponse.success(data);
14
+ return generateResponse.success(data);
14
15
  };
15
16
  // 用户登录
16
17
  export const loginUser = async ({ email, password }) => {
@@ -21,7 +22,7 @@ export const loginUser = async ({ email, password }) => {
21
22
  if (error) {
22
23
  handleSupabaseError("loginUser", error, "Login failed. Please check your credentials.");
23
24
  }
24
- return createResponse.success(data);
25
+ return generateResponse.success(data);
25
26
  };
26
27
  // 用户登出
27
28
  export const logoutUser = async () => {
@@ -29,7 +30,7 @@ export const logoutUser = async () => {
29
30
  if (error) {
30
31
  handleSupabaseError("logoutUser", error, "Logout failed.");
31
32
  }
32
- return createResponse.success();
33
+ return generateResponse.success();
33
34
  };
34
35
  // 获取当前用户
35
36
  export const getCurrentUser = async () => {
@@ -37,7 +38,7 @@ export const getCurrentUser = async () => {
37
38
  if (error) {
38
39
  handleSupabaseError("getCurrentUser", error, "Failed to get current user.");
39
40
  }
40
- return createResponse.success(user);
41
+ return generateResponse.success(user);
41
42
  };
42
43
  // 重置密码
43
44
  export const resetPassword = async (email) => {
@@ -45,6 +46,6 @@ export const resetPassword = async (email) => {
45
46
  if (error) {
46
47
  handleSupabaseError("resetPassword", error, "Password reset request failed.");
47
48
  }
48
- return createResponse.success();
49
+ return generateResponse.success();
49
50
  };
50
51
  //# sourceMappingURL=auth.api.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"auth.api.js","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAoBpD,OAAO;AACP,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAmB,EAAE,EAAE;IACzE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7D,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAgB,EAAE,EAAE;IACnE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACzE,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE5D,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,SAAS;AACT,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IACvC,MAAM,EACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EACd,KAAK,GACN,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,CAAc,IAAmB,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;IACnD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE/E,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,eAAe,EAAE,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,EAAE,CAAC;AAClC,CAAC,CAAC"}
1
+ {"version":3,"file":"auth.api.js","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;AAoBnD,OAAO;AACP,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAmB,EAAE,EAAE;IACzE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7D,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAgB,EAAE,EAAE;IACnE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACzE,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE5D,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC;AAEF,SAAS;AACT,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IACvC,MAAM,EACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EACd,KAAK,GACN,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAc,IAAmB,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;IACnD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE/E,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,eAAe,EAAE,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC"}
@@ -0,0 +1,43 @@
1
+ import { z } from "zod";
2
+ import { Command, CommandType } from "./command.interface";
3
+ export declare const postCommandSchema: z.ZodObject<{
4
+ nodeId: z.ZodString;
5
+ command: z.ZodNativeEnum<typeof CommandType>;
6
+ traceId: z.ZodOptional<z.ZodString>;
7
+ }, "strip", z.ZodTypeAny, {
8
+ nodeId: string;
9
+ command: CommandType;
10
+ traceId?: string | undefined;
11
+ }, {
12
+ nodeId: string;
13
+ command: CommandType;
14
+ traceId?: string | undefined;
15
+ }>;
16
+ export type PostCommandPayload = z.infer<typeof postCommandSchema>;
17
+ export declare const getPollCommandListSchema: z.ZodObject<{
18
+ nodeId: z.ZodString;
19
+ size: z.ZodOptional<z.ZodNumber>;
20
+ traceId: z.ZodOptional<z.ZodString>;
21
+ }, "strip", z.ZodTypeAny, {
22
+ nodeId: string;
23
+ size?: number | undefined;
24
+ traceId?: string | undefined;
25
+ }, {
26
+ nodeId: string;
27
+ size?: number | undefined;
28
+ traceId?: string | undefined;
29
+ }>;
30
+ export type GetPollCommandListPayload = z.infer<typeof getPollCommandListSchema>;
31
+ /** Enqueue a control command for `nodeId` (scheduler / admin). */
32
+ export declare const postCommand: (payload: {
33
+ nodeId: string;
34
+ command: CommandType;
35
+ traceId?: string | undefined;
36
+ }) => import("..").SupabaseResponse<Command> | Promise<import("..").SupabaseResponse<Command>>;
37
+ /** Dequeue control commands for `nodeId` (oldest first). */
38
+ export declare const getPollCommandList: (payload: {
39
+ nodeId: string;
40
+ size?: number | undefined;
41
+ traceId?: string | undefined;
42
+ }) => import("..").SupabaseResponse<Command[]> | Promise<import("..").SupabaseResponse<Command[]>>;
43
+ //# sourceMappingURL=command.api.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.api.d.ts","sourceRoot":"","sources":["../../src/command/command.api.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAO5E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAUjF,kEAAkE;AAClE,eAAO,MAAM,WAAW;;;;8FAsBtB,CAAC;AAIH,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;kGAmB7B,CAAC"}
@@ -0,0 +1,58 @@
1
+ import { createTarget, MAX_POLL_TARGET_LIST_SIZE, pollTargetList, validateWithSchema, } from "../core.api";
2
+ import { generateResponse } from "../core.interface";
3
+ import { createApiLogger } from "../shared/log/log-manager";
4
+ import { z } from "zod";
5
+ import { CategoryCommand, CommandType } from "./command.interface";
6
+ const nodeIdSchema = z.string().trim().min(1);
7
+ const traceIdSchema = z.string().trim().min(1).optional();
8
+ // ─── Zod schemas ─────────────────────────────────────────────────────────────
9
+ export const postCommandSchema = z.object({
10
+ nodeId: nodeIdSchema,
11
+ command: z.nativeEnum(CommandType),
12
+ traceId: traceIdSchema,
13
+ });
14
+ export const getPollCommandListSchema = z.object({
15
+ nodeId: nodeIdSchema,
16
+ size: z.number().int().min(1).max(MAX_POLL_TARGET_LIST_SIZE).optional(),
17
+ traceId: traceIdSchema,
18
+ });
19
+ // ─── Helpers ─────────────────────────────────────────────────────────────────
20
+ function commandNodeFilter(nodeId) {
21
+ return [{ field: "value", operator: "eq", value: nodeId }];
22
+ }
23
+ // ─── postCommand ─────────────────────────────────────────────────────────────
24
+ /** Enqueue a control command for `nodeId` (scheduler / admin). */
25
+ export const postCommand = validateWithSchema(postCommandSchema, "postCommandSchema")(async ({ nodeId, command, traceId }) => {
26
+ const logger = createApiLogger("postCommand", { traceId, nodeId });
27
+ const result = await createTarget({
28
+ payload: { nodeId, command, traceId },
29
+ createFn: () => ({
30
+ name: command,
31
+ value: nodeId,
32
+ category: CategoryCommand.COMMAND,
33
+ tagList: [],
34
+ }),
35
+ });
36
+ logger.info("Command已入隊", {
37
+ topic: "command",
38
+ context: { nodeId, command },
39
+ });
40
+ return result;
41
+ });
42
+ // ─── getPollCommandList ──────────────────────────────────────────────────────
43
+ /** Dequeue control commands for `nodeId` (oldest first). */
44
+ export const getPollCommandList = validateWithSchema(getPollCommandListSchema, "getPollCommandListSchema")(async ({ nodeId, size, traceId }) => {
45
+ const logger = createApiLogger("getPollCommandList", { traceId, nodeId });
46
+ const { data: dequeuedList = [] } = await pollTargetList({
47
+ category: CategoryCommand.COMMAND,
48
+ size: size ?? 50,
49
+ filterList: commandNodeFilter(nodeId),
50
+ ascending: true,
51
+ });
52
+ logger.info("Command", {
53
+ topic: "command",
54
+ context: { nodeId, dequeued: dequeuedList.length },
55
+ });
56
+ return generateResponse.success(dequeuedList);
57
+ });
58
+ //# sourceMappingURL=command.api.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.api.js","sourceRoot":"","sources":["../../src/command/command.api.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { Target } from "../core.interface";
2
+ export declare enum CategoryCommand {
3
+ COMMAND = "command"
4
+ }
5
+ export declare enum CommandType {
6
+ STOP_NODE = "stop-node"
7
+ }
8
+ export interface Command extends Target {
9
+ name: CommandType;
10
+ /** Node.id */
11
+ value: string;
12
+ category: CategoryCommand;
13
+ }
14
+ //# sourceMappingURL=command.interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../src/command/command.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,oBAAY,eAAe;IACvB,OAAO,YAAY;CACtB;AAED,oBAAY,WAAW;IACnB,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;CAC7B"}
@@ -0,0 +1,9 @@
1
+ export var CategoryCommand;
2
+ (function (CategoryCommand) {
3
+ CategoryCommand["COMMAND"] = "command";
4
+ })(CategoryCommand || (CategoryCommand = {}));
5
+ export var CommandType;
6
+ (function (CommandType) {
7
+ CommandType["STOP_NODE"] = "stop-node";
8
+ })(CommandType || (CommandType = {}));
9
+ //# sourceMappingURL=command.interface.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"command.interface.js","sourceRoot":"","sources":["../../src/command/command.interface.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACvB,sCAAmB,CAAA;AACvB,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B;AAED,MAAM,CAAN,IAAY,WAEX;AAFD,WAAY,WAAW;IACnB,sCAAuB,CAAA;AAC3B,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB"}
@@ -1,11 +1,16 @@
1
- import { Target } from "./core.interface";
1
+ import { Target, TargetPayload } from "./core.interface";
2
2
  import { BaseValidator } from "./core.utils";
3
3
  import { PostgrestFilterBuilder } from "@supabase/postgrest-js";
4
+ import type { ZodType } from "zod";
4
5
  export interface QueryFilter {
5
6
  field: string;
6
- operator: "eq";
7
+ operator: "eq" | "neq" | "in";
7
8
  value: unknown;
8
9
  }
10
+ export declare const MAX_TARGET_LIST_PAGE_SIZE = 100;
11
+ /** Alias for {@link pollTargetList} batch size cap. */
12
+ export declare const MAX_POLL_TARGET_LIST_SIZE = 100;
13
+ export type TargetFilterBuilder = PostgrestFilterBuilder<any, any, any[], "target", unknown>;
9
14
  export interface QueryOrderBy {
10
15
  field: string;
11
16
  ascending: boolean;
@@ -22,18 +27,75 @@ export declare const getPossibleTarget: ({ filterList }: {
22
27
  filterList: QueryFilter[];
23
28
  }) => Promise<import("./core.interface").SupabaseResponse<Target | null>>;
24
29
  export interface GetTargetListParams extends BaseQueryParams {
25
- pageNum: number;
26
- pageSize: number;
27
30
  category: Target["category"];
31
+ /** 0-based page index. Required with pageSize unless `limit` is set. */
32
+ pageNum?: number;
33
+ pageSize?: number;
34
+ /** Shorthand for `{ pageNum: 0, pageSize: limit }`. Max {@link MAX_TARGET_LIST_PAGE_SIZE}. */
35
+ limit?: number;
36
+ /** PostgREST select clause; defaults to `"*"`. */
37
+ selectFields?: string;
38
+ /** Custom query builder; `category` and `filterList` are still applied. */
39
+ filterBuilder?: TargetFilterBuilder;
28
40
  }
29
- export declare const getTargetList: ({ pageNum, pageSize, category, filterList, orderBy, filterBuilder, }: GetTargetListParams & {
30
- filterBuilder?: PostgrestFilterBuilder<any, any, any[], "target", unknown>;
31
- }) => Promise<import("./core.interface").SupabaseResponse<Target[]>>;
41
+ /**
42
+ * Paginated target list by category. Failures throw via `handleSupabaseError` (no `{ error }` envelope).
43
+ */
44
+ export declare const getTargetList: <T extends Target = Target>({ pageNum, pageSize, limit, category, filterList, orderBy, selectFields, filterBuilder, }: GetTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
45
+ export interface ScanTargetListParams {
46
+ category: Target["category"];
47
+ filterList?: QueryFilter[];
48
+ orderBy?: QueryOrderBy;
49
+ selectFields?: string;
50
+ filterBuilder?: TargetFilterBuilder;
51
+ /** Stop after this many rows (optional guard against runaway scans). */
52
+ maxRows?: number;
53
+ }
54
+ /**
55
+ * Scan all rows matching `category` + `filterList` by paging until exhausted.
56
+ *
57
+ * Use for worker bootstrap / sync jobs that need the full matching set.
58
+ * For UI pagination, use {@link getTargetList} (single page, explicit pageNum).
59
+ *
60
+ * Internal batch size is fixed at {@link MAX_TARGET_LIST_PAGE_SIZE} (PostgREST max-rows).
61
+ * Callers receive the full merged result; they do not pass a per-request page size.
62
+ *
63
+ * Uses offset pagination (`.range`). Stable enough for small catalogs (e.g. Repo registry);
64
+ * for large tables under concurrent writes, consider a DB RPC or keyset pagination later.
65
+ */
66
+ export declare const scanTargetList: <T extends Target = Target>({ category, filterList, orderBy, selectFields, filterBuilder, maxRows, }: ScanTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
32
67
  export interface GetTargetTotalCountParams extends BaseQueryParams {
33
68
  category: Target["category"];
34
- filterBuilder?: PostgrestFilterBuilder<any, any, any[], "target", unknown>;
69
+ /** Custom query builder; `category` and `filterList` are still applied. */
70
+ filterBuilder?: TargetFilterBuilder;
35
71
  }
36
72
  export declare const getTargetTotalCount: ({ category, filterList, filterBuilder, }: GetTargetTotalCountParams) => Promise<import("./core.interface").SupabaseResponse<number>>;
73
+ export interface PollTargetListParams {
74
+ category: Target["category"];
75
+ /** Max rows to read and attempt dequeue (not offset pagination). */
76
+ size: number;
77
+ filterList?: QueryFilter[];
78
+ /** Order by `created_at`. Default `true` (oldest first). */
79
+ ascending?: boolean;
80
+ selectFields?: string;
81
+ }
82
+ /**
83
+ * Queue poll: SELECT up to `size` rows matching `category` + `filterList`, ordered by
84
+ * `created_at`, then DELETE each by `id`. Returns only dequeued rows (at-most-once).
85
+ *
86
+ * Delete failures (concurrent consumer) are skipped silently.
87
+ * Failures on the initial SELECT throw via `handleSupabaseError`.
88
+ *
89
+ * TODO(concurrency): 当前为 SELECT → 逐条 DELETE,非 DB 原子出队,多 consumer 并发时可能:
90
+ * - 重叠读取:两个 worker 同一批 SELECT 命中相同行,靠 DELETE 竞速,后者 skip(多数 at-most-once)
91
+ * - TOCTOU:SELECT 与 DELETE 之间无锁,极端情况下 DELETE 0 行仍不报错 → 可能重复计入 polled
92
+ * - 非 exactly-once:行已删但 worker 崩溃未处理 → 消息丢失
93
+ * 若同一 filter 多实例 poll(或多 worker 同 nodeId),需改为 DB 侧原子方案,例如:
94
+ * - RPC:`DELETE … WHERE id IN (SELECT … FOR UPDATE SKIP LOCKED) RETURNING *`
95
+ * - 或 claim 状态机:UPDATE … WHERE pending → DELETE/标记已消费(类似 patchClaimTask 乐观锁)
96
+ * - 短期加固:DELETE 后校验影响行数,0 行则不 push 到 polled
97
+ */
98
+ export declare const pollTargetList: <T extends Target = Target>({ category, size, filterList, ascending, selectFields, }: PollTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
37
99
  export declare const deleteTarget: ({ id, filterList }: {
38
100
  id: string;
39
101
  filterList?: QueryFilter[];
@@ -51,18 +113,60 @@ export interface PatchTargetPayload extends PostTargetPayload {
51
113
  id: string;
52
114
  }
53
115
  export declare const patchTarget: ({ id, ...restPayload }: PatchTargetPayload) => Promise<import("./core.interface").SupabaseResponse<Target>>;
54
- export declare const updateTargetDetails: <T, D>({ id, updateFn, beforeUpdateValidator, updateExtraFn, }: {
116
+ /**
117
+ * Read-modify-write `target.details` with optional DB-level optimistic locking on UPDATE.
118
+ *
119
+ * Do not use application-layer pre-update validators (e.g. checking state after SELECT then
120
+ * UPDATE with only `id`). That pattern is not atomic and loses under concurrency. Pass expected
121
+ * row conditions via `optimisticLockFilterList` so they are applied on the UPDATE statement.
122
+ */
123
+ export interface UpdateTargetDetailsParams<D> {
124
+ /** Target row id. */
55
125
  id: string;
126
+ /**
127
+ * Computes new details from the row fetched immediately before UPDATE.
128
+ * Runs after SELECT; the write still relies on `optimisticLockFilterList` for atomic guards.
129
+ */
56
130
  updateFn: (existing: D) => D;
57
- beforeUpdateValidator?: (existing: D) => true | string;
131
+ /**
132
+ * Optional `target.extra` derived from existing details (written together with details).
133
+ */
58
134
  updateExtraFn?: (existing: D) => string;
59
- }) => Promise<T>;
135
+ /**
136
+ * Optimistic lock conditions applied on UPDATE (not on the prior SELECT).
137
+ *
138
+ * Replaces the removed `beforeUpdateValidator`: validators ran in app code between read and
139
+ * write and could not prevent concurrent overwrites. These filters become part of the UPDATE
140
+ * WHERE clause (via `applyQueryFilters`), e.g. `{ field: "details->>status", operator: "eq", value: "TODO" }`.
141
+ *
142
+ * If no row matches after UPDATE, throws "Optimistic lock failed". Empty array = update by id only.
143
+ */
144
+ optimisticLockFilterList?: QueryFilter[];
145
+ }
146
+ export declare const updateTargetDetails: <T, D>({ id, updateFn, updateExtraFn, optimisticLockFilterList, }: UpdateTargetDetailsParams<D>) => Promise<T>;
147
+ export declare const OPTIMISTIC_LOCK_FAILED_MESSAGE = "[updateTargetDetails] Optimistic lock failed: target no longer matches expected state.";
148
+ export declare const CREATE_TARGET_ALREADY_EXISTS_MESSAGE = "[createTarget] Target already exists";
149
+ export declare function isOptimisticLockError(error: unknown): boolean;
150
+ export declare function isCreateTargetAlreadyExistsError(error: unknown): boolean;
151
+ /**
152
+ * Create a `target` row with optional payload validation and optimistic redundancy checks.
153
+ *
154
+ * When `checkRedundancyFilterList` is set, uses insert-first + post-verify (not SELECT-before-INSERT).
155
+ * See `.cursor/skills/create-target-redundancy/SKILL.md`.
156
+ */
60
157
  export declare const createTarget: <T extends Target, P extends object>({ payload, validator, createFn, checkRedundancyFilterList, upsert, }: {
61
158
  payload: P;
62
159
  validator?: new () => BaseValidator<P>;
63
- createFn: (validPayload: P) => Omit<T, "id" | "created_at">;
160
+ createFn: (validPayload: P) => TargetPayload<T>;
161
+ /** Business-key filters; if another row matches after insert, conflict handling runs. */
64
162
  checkRedundancyFilterList?: QueryFilter[];
163
+ /**
164
+ * @deprecated Not supported — ignored at runtime. Use domain patch APIs or future RPC upsert.
165
+ * Reserved for a later release; do not pass `true`.
166
+ */
65
167
  upsert?: boolean;
66
168
  }) => Promise<import("./core.interface").SupabaseResponse<T>>;
67
169
  export declare function validateWith<P extends object, V extends BaseValidator<P>>(ValidatorClass: new () => V): <R>(fn: (validPayload: P) => R) => (payload: P) => R;
170
+ /** Zod-based counterpart to {@link validateWith} — requires `zod` as a peer dependency. */
171
+ export declare function validateWithSchema<T extends ZodType>(schema: T, schemaName?: string): <R>(fn: (validPayload: T["_output"]) => R | Promise<R>) => (payload: T["_output"]) => R | Promise<R>;
68
172
  //# sourceMappingURL=core.api.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"core.api.d.ts","sourceRoot":"","sources":["../src/core.api.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"core.api.d.ts","sourceRoot":"","sources":["../src/core.api.ts"],"names":[],"mappings":"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"}