@zuiio/supabase 0.1.0 → 0.2.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 (64) hide show
  1. package/README.md +21 -0
  2. package/dist/api-response.d.ts +25 -0
  3. package/dist/api-response.d.ts.map +1 -0
  4. package/{src/api-response.ts → dist/api-response.js} +8 -16
  5. package/dist/api-response.js.map +1 -0
  6. package/dist/auth.d.ts +27 -0
  7. package/dist/auth.d.ts.map +1 -0
  8. package/dist/auth.js +55 -0
  9. package/dist/auth.js.map +1 -0
  10. package/dist/errors.d.ts +7 -0
  11. package/dist/errors.d.ts.map +1 -0
  12. package/dist/errors.js +36 -0
  13. package/dist/errors.js.map +1 -0
  14. package/dist/index.d.ts +7 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/{src/index.ts → dist/index.js} +1 -1
  17. package/dist/index.js.map +1 -0
  18. package/dist/query.d.ts +30 -0
  19. package/dist/query.d.ts.map +1 -0
  20. package/dist/query.js +74 -0
  21. package/dist/query.js.map +1 -0
  22. package/dist/r2-storage.d.ts +24 -0
  23. package/dist/r2-storage.d.ts.map +1 -0
  24. package/dist/r2-storage.js +78 -0
  25. package/dist/r2-storage.js.map +1 -0
  26. package/dist/storage.d.ts +20 -0
  27. package/dist/storage.d.ts.map +1 -0
  28. package/dist/storage.js +38 -0
  29. package/dist/storage.js.map +1 -0
  30. package/dist/turnstile.d.ts +13 -0
  31. package/dist/turnstile.d.ts.map +1 -0
  32. package/dist/turnstile.js +45 -0
  33. package/dist/turnstile.js.map +1 -0
  34. package/dist/with-batch.d.ts +69 -0
  35. package/dist/with-batch.d.ts.map +1 -0
  36. package/dist/with-batch.js +130 -0
  37. package/dist/with-batch.js.map +1 -0
  38. package/{src/with-org-branch-filter.ts → dist/with-org-branch-filter.d.ts} +2 -4
  39. package/dist/with-org-branch-filter.d.ts.map +1 -0
  40. package/dist/with-org-branch-filter.js +22 -0
  41. package/dist/with-org-branch-filter.js.map +1 -0
  42. package/{src/with-org-scope.ts → dist/with-org-scope.d.ts} +2 -4
  43. package/dist/with-org-scope.d.ts.map +1 -0
  44. package/dist/with-org-scope.js +26 -0
  45. package/dist/with-org-scope.js.map +1 -0
  46. package/dist/with-pagination.d.ts +17 -0
  47. package/dist/with-pagination.d.ts.map +1 -0
  48. package/{src/with-pagination.ts → dist/with-pagination.js} +7 -10
  49. package/dist/with-pagination.js.map +1 -0
  50. package/dist/workers-ai.d.ts +33 -0
  51. package/dist/workers-ai.d.ts.map +1 -0
  52. package/dist/workers-ai.js +114 -0
  53. package/dist/workers-ai.js.map +1 -0
  54. package/package.json +54 -18
  55. package/AGENTS.md +0 -84
  56. package/src/auth.ts +0 -86
  57. package/src/errors.ts +0 -42
  58. package/src/query.ts +0 -108
  59. package/src/r2-storage.ts +0 -98
  60. package/src/storage.ts +0 -68
  61. package/src/turnstile.ts +0 -61
  62. package/src/with-batch.ts +0 -172
  63. package/src/workers-ai.ts +0 -172
  64. package/tsconfig.json +0 -7
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Validate a Cloudflare Turnstile token server-side.
3
+ * Call this in server actions / API routes after the client submits the form.
4
+ *
5
+ * @param token - The `cf-turnstile-response` value from the hidden form field
6
+ * @param remoteIp - Optional: the user's IP for extra validation
7
+ * @returns `{ success: true }` or `{ success: false, error: string }`
8
+ */
9
+ export async function validateTurnstile(token, remoteIp) {
10
+ // Always skip in development — the widget isn't rendered there
11
+ if (process.env.NODE_ENV === "development") {
12
+ return { success: true };
13
+ }
14
+ const secretKey = process.env.CLOUDFLARE_TURNSTILE_SECRET_KEY;
15
+ if (!secretKey) {
16
+ // No secret key configured = Turnstile not set up — skip validation
17
+ return { success: true };
18
+ }
19
+ if (!token) {
20
+ return { success: false, error: "Missing Turnstile token" };
21
+ }
22
+ const formData = new URLSearchParams();
23
+ formData.append("secret", secretKey);
24
+ formData.append("response", token);
25
+ if (remoteIp) {
26
+ formData.append("remoteip", remoteIp);
27
+ }
28
+ try {
29
+ const res = await fetch("https://challenges.cloudflare.com/turnstile/v0/siteverify", {
30
+ method: "POST",
31
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
32
+ body: formData.toString(),
33
+ });
34
+ const result = (await res.json());
35
+ if (!result.success) {
36
+ return { success: false, error: "Bot verification failed" };
37
+ }
38
+ return { success: true };
39
+ }
40
+ catch {
41
+ // Fail open on network errors to avoid locking out users
42
+ return { success: true };
43
+ }
44
+ }
45
+ //# sourceMappingURL=turnstile.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"turnstile.js","sourceRoot":"","sources":["../src/turnstile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAgC,EAChC,QAAiB;IAEjB,+DAA+D;IAC/D,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;IAC9D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,oEAAoE;QACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,2DAA2D,EAC3D;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;SAC1B,CACF,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG/B,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QAC9D,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;QACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC","sourcesContent":["/**\n * Validate a Cloudflare Turnstile token server-side.\n * Call this in server actions / API routes after the client submits the form.\n *\n * @param token - The `cf-turnstile-response` value from the hidden form field\n * @param remoteIp - Optional: the user's IP for extra validation\n * @returns `{ success: true }` or `{ success: false, error: string }`\n */\nexport async function validateTurnstile(\n token: string | null | undefined,\n remoteIp?: string,\n): Promise<{ success: boolean; error?: string }> {\n // Always skip in development — the widget isn't rendered there\n if (process.env.NODE_ENV === \"development\") {\n return { success: true };\n }\n\n const secretKey = process.env.CLOUDFLARE_TURNSTILE_SECRET_KEY;\n if (!secretKey) {\n // No secret key configured = Turnstile not set up — skip validation\n return { success: true };\n }\n\n if (!token) {\n return { success: false, error: \"Missing Turnstile token\" };\n }\n\n const formData = new URLSearchParams();\n formData.append(\"secret\", secretKey);\n formData.append(\"response\", token);\n if (remoteIp) {\n formData.append(\"remoteip\", remoteIp);\n }\n\n try {\n const res = await fetch(\n \"https://challenges.cloudflare.com/turnstile/v0/siteverify\",\n {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/x-www-form-urlencoded\" },\n body: formData.toString(),\n },\n );\n\n const result = (await res.json()) as {\n success: boolean;\n \"error-codes\"?: string[];\n };\n\n if (!result.success) {\n return { success: false, error: \"Bot verification failed\" };\n }\n\n return { success: true };\n } catch {\n // Fail open on network errors to avoid locking out users\n return { success: true };\n }\n}\n"]}
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Batch upsert helper — reliable bulk operations with chunking,
3
+ * conflict handling, and per-row error visibility.
4
+ *
5
+ * Supabase pitfalls it addresses:
6
+ * - Missing UNIQUE constraint → upsert silently inserts duplicates
7
+ * (throws here instead of silently corrupting data)
8
+ * - Oversized batches → auto-chunks into safe request sizes
9
+ * - Immutable field reset → use checkThenUpsert to preserve fields
10
+ * during recalculation operations
11
+ */
12
+ export interface BatchUpsertOptions {
13
+ /** Column(s) for ON CONFLICT resolution (required for upsert) */
14
+ onConflict?: string;
15
+ /** Ignore duplicate rows instead of updating them */
16
+ ignoreDuplicates?: boolean;
17
+ /** Max rows per API call (default: 50) */
18
+ chunkSize?: number;
19
+ }
20
+ export interface BatchResult {
21
+ inserted: number;
22
+ errors: Array<{
23
+ index: number;
24
+ row: unknown;
25
+ error: string;
26
+ }>;
27
+ }
28
+ /**
29
+ * Upserts rows in chunks, collecting per-row errors so a partial
30
+ * failure doesn't lose the entire batch.
31
+ *
32
+ * Requires `onConflict` to be set (throws if omitted) — this prevents
33
+ * the silent duplicate-insertion pitfall.
34
+ *
35
+ * @example
36
+ * const result = await batchUpsert(
37
+ * supabase,
38
+ * "inventory_movements",
39
+ * movements,
40
+ * { onConflict: "id" },
41
+ * );
42
+ */
43
+ export declare function batchUpsert<T extends Record<string, unknown>>(supabase: {
44
+ from: (table: string) => any;
45
+ }, table: string, rows: T[], options?: BatchUpsertOptions): Promise<BatchResult>;
46
+ /**
47
+ * Check-then-upsert pattern for recalculation operations where
48
+ * certain fields (status, immutable timestamps) must be preserved.
49
+ *
50
+ * Reads existing rows matching the conflict keys, merges the incoming
51
+ * data with preserved fields, then upserts.
52
+ *
53
+ * @example
54
+ * const result = await checkThenUpsert(
55
+ * supabase,
56
+ * "payroll_records",
57
+ * recalculatedRows,
58
+ * { onConflict: "id", preserve: ["status", "paid_at"] },
59
+ * );
60
+ */
61
+ export declare function checkThenUpsert<T extends Record<string, unknown>>(supabase: {
62
+ from: (table: string) => any;
63
+ }, table: string, rows: T[], options: BatchUpsertOptions & {
64
+ /** Fields to preserve from existing rows instead of overwriting */
65
+ preserve: string[];
66
+ /** Column to use for querying existing rows (default: "id") */
67
+ lookupKey?: string;
68
+ }): Promise<BatchResult>;
69
+ //# sourceMappingURL=with-batch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-batch.d.ts","sourceRoot":"","sources":["../src/with-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAUD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,QAAQ,EAAE;IAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;CAAE,EAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAsDtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,QAAQ,EAAE;IAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAAA;CAAE,EAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,kBAAkB,GAAG;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,WAAW,CAAC,CAkCtB"}
@@ -0,0 +1,130 @@
1
+ /**
2
+ * Batch upsert helper — reliable bulk operations with chunking,
3
+ * conflict handling, and per-row error visibility.
4
+ *
5
+ * Supabase pitfalls it addresses:
6
+ * - Missing UNIQUE constraint → upsert silently inserts duplicates
7
+ * (throws here instead of silently corrupting data)
8
+ * - Oversized batches → auto-chunks into safe request sizes
9
+ * - Immutable field reset → use checkThenUpsert to preserve fields
10
+ * during recalculation operations
11
+ */
12
+ const DEFAULT_CHUNK_SIZE = 50;
13
+ function chunkArray(arr, size) {
14
+ const chunks = [];
15
+ for (let i = 0; i < arr.length; i += size) {
16
+ chunks.push(arr.slice(i, i + size));
17
+ }
18
+ return chunks;
19
+ }
20
+ /**
21
+ * Upserts rows in chunks, collecting per-row errors so a partial
22
+ * failure doesn't lose the entire batch.
23
+ *
24
+ * Requires `onConflict` to be set (throws if omitted) — this prevents
25
+ * the silent duplicate-insertion pitfall.
26
+ *
27
+ * @example
28
+ * const result = await batchUpsert(
29
+ * supabase,
30
+ * "inventory_movements",
31
+ * movements,
32
+ * { onConflict: "id" },
33
+ * );
34
+ */
35
+ export async function batchUpsert(supabase, table, rows, options) {
36
+ if (!options?.onConflict) {
37
+ throw new Error("batchUpsert: `onConflict` is required. " +
38
+ "Without it, upsert silently inserts duplicates when the UNIQUE constraint is missing. " +
39
+ "Set onConflict to the column(s) that define uniqueness for this table.");
40
+ }
41
+ if (rows.length === 0) {
42
+ return { inserted: 0, errors: [] };
43
+ }
44
+ const chunkSize = options?.chunkSize ?? DEFAULT_CHUNK_SIZE;
45
+ const chunks = chunkArray(rows, chunkSize);
46
+ let inserted = 0;
47
+ const errors = [];
48
+ for (const chunk of chunks) {
49
+ try {
50
+ const query = supabase
51
+ .from(table)
52
+ .upsert(chunk, {
53
+ onConflict: options.onConflict,
54
+ ignoreDuplicates: options.ignoreDuplicates ?? false,
55
+ })
56
+ .select();
57
+ const { error } = await query;
58
+ if (error) {
59
+ for (let i = 0; i < chunk.length; i++) {
60
+ errors.push({
61
+ index: inserted + i,
62
+ row: chunk[i],
63
+ error: error.message,
64
+ });
65
+ }
66
+ }
67
+ else {
68
+ inserted += chunk.length;
69
+ }
70
+ }
71
+ catch (err) {
72
+ const message = err instanceof Error ? err.message : String(err);
73
+ for (let i = 0; i < chunk.length; i++) {
74
+ errors.push({
75
+ index: inserted + i,
76
+ row: chunk[i],
77
+ error: message,
78
+ });
79
+ }
80
+ }
81
+ }
82
+ return { inserted, errors };
83
+ }
84
+ /**
85
+ * Check-then-upsert pattern for recalculation operations where
86
+ * certain fields (status, immutable timestamps) must be preserved.
87
+ *
88
+ * Reads existing rows matching the conflict keys, merges the incoming
89
+ * data with preserved fields, then upserts.
90
+ *
91
+ * @example
92
+ * const result = await checkThenUpsert(
93
+ * supabase,
94
+ * "payroll_records",
95
+ * recalculatedRows,
96
+ * { onConflict: "id", preserve: ["status", "paid_at"] },
97
+ * );
98
+ */
99
+ export async function checkThenUpsert(supabase, table, rows, options) {
100
+ const lookupKey = options.lookupKey ?? "id";
101
+ const ids = rows
102
+ .map((r) => r[lookupKey])
103
+ .filter((id) => id != null);
104
+ const existingMap = new Map();
105
+ if (ids.length > 0) {
106
+ const { data: existing } = await supabase
107
+ .from(table)
108
+ .select(`*`)
109
+ .in(lookupKey, ids);
110
+ if (existing) {
111
+ for (const row of existing) {
112
+ existingMap.set(row[lookupKey], row);
113
+ }
114
+ }
115
+ }
116
+ const merged = rows.map((row) => {
117
+ const existing = existingMap.get(row[lookupKey]);
118
+ if (!existing)
119
+ return row;
120
+ const result = { ...row };
121
+ for (const field of options.preserve) {
122
+ if (field in existing) {
123
+ result[field] = existing[field];
124
+ }
125
+ }
126
+ return result;
127
+ });
128
+ return batchUpsert(supabase, table, merged, options);
129
+ }
130
+ //# sourceMappingURL=with-batch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-batch.js","sourceRoot":"","sources":["../src/with-batch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Batch upsert helper — reliable bulk operations with chunking,\n * conflict handling, and per-row error visibility.\n *\n * Supabase pitfalls it addresses:\n * - Missing UNIQUE constraint → upsert silently inserts duplicates\n * (throws here instead of silently corrupting data)\n * - Oversized batches → auto-chunks into safe request sizes\n * - Immutable field reset → use checkThenUpsert to preserve fields\n * during recalculation operations\n */\n\nconst DEFAULT_CHUNK_SIZE = 50;\n\nexport interface BatchUpsertOptions {\n /** Column(s) for ON CONFLICT resolution (required for upsert) */\n onConflict?: string;\n /** Ignore duplicate rows instead of updating them */\n ignoreDuplicates?: boolean;\n /** Max rows per API call (default: 50) */\n chunkSize?: number;\n}\n\nexport interface BatchResult {\n inserted: number;\n errors: Array<{ index: number; row: unknown; error: string }>;\n}\n\nfunction chunkArray<T>(arr: T[], size: number): T[][] {\n const chunks: T[][] = [];\n for (let i = 0; i < arr.length; i += size) {\n chunks.push(arr.slice(i, i + size));\n }\n return chunks;\n}\n\n/**\n * Upserts rows in chunks, collecting per-row errors so a partial\n * failure doesn't lose the entire batch.\n *\n * Requires `onConflict` to be set (throws if omitted) — this prevents\n * the silent duplicate-insertion pitfall.\n *\n * @example\n * const result = await batchUpsert(\n * supabase,\n * \"inventory_movements\",\n * movements,\n * { onConflict: \"id\" },\n * );\n */\nexport async function batchUpsert<T extends Record<string, unknown>>(\n supabase: { from: (table: string) => any },\n table: string,\n rows: T[],\n options?: BatchUpsertOptions,\n): Promise<BatchResult> {\n if (!options?.onConflict) {\n throw new Error(\n \"batchUpsert: `onConflict` is required. \" +\n \"Without it, upsert silently inserts duplicates when the UNIQUE constraint is missing. \" +\n \"Set onConflict to the column(s) that define uniqueness for this table.\",\n );\n }\n\n if (rows.length === 0) {\n return { inserted: 0, errors: [] };\n }\n\n const chunkSize = options?.chunkSize ?? DEFAULT_CHUNK_SIZE;\n const chunks = chunkArray(rows, chunkSize);\n let inserted = 0;\n const errors: BatchResult[\"errors\"] = [];\n\n for (const chunk of chunks) {\n try {\n const query = supabase\n .from(table)\n .upsert(chunk, {\n onConflict: options.onConflict,\n ignoreDuplicates: options.ignoreDuplicates ?? false,\n })\n .select();\n\n const { error } = await query;\n\n if (error) {\n for (let i = 0; i < chunk.length; i++) {\n errors.push({\n index: inserted + i,\n row: chunk[i],\n error: error.message,\n });\n }\n } else {\n inserted += chunk.length;\n }\n } catch (err) {\n const message = err instanceof Error ? err.message : String(err);\n for (let i = 0; i < chunk.length; i++) {\n errors.push({\n index: inserted + i,\n row: chunk[i],\n error: message,\n });\n }\n }\n }\n\n return { inserted, errors };\n}\n\n/**\n * Check-then-upsert pattern for recalculation operations where\n * certain fields (status, immutable timestamps) must be preserved.\n *\n * Reads existing rows matching the conflict keys, merges the incoming\n * data with preserved fields, then upserts.\n *\n * @example\n * const result = await checkThenUpsert(\n * supabase,\n * \"payroll_records\",\n * recalculatedRows,\n * { onConflict: \"id\", preserve: [\"status\", \"paid_at\"] },\n * );\n */\nexport async function checkThenUpsert<T extends Record<string, unknown>>(\n supabase: { from: (table: string) => any },\n table: string,\n rows: T[],\n options: BatchUpsertOptions & {\n /** Fields to preserve from existing rows instead of overwriting */\n preserve: string[];\n /** Column to use for querying existing rows (default: \"id\") */\n lookupKey?: string;\n },\n): Promise<BatchResult> {\n const lookupKey = options.lookupKey ?? \"id\";\n const ids = rows\n .map((r) => r[lookupKey])\n .filter((id): id is string | number => id != null);\n\n const existingMap = new Map<string | number, Record<string, unknown>>();\n if (ids.length > 0) {\n const { data: existing } = await supabase\n .from(table)\n .select(`*`)\n .in(lookupKey, ids);\n\n if (existing) {\n for (const row of existing) {\n existingMap.set(row[lookupKey] as string | number, row);\n }\n }\n }\n\n const merged = rows.map((row) => {\n const existing = existingMap.get(row[lookupKey] as string | number);\n if (!existing) return row;\n\n const result = { ...row } as Record<string, unknown>;\n for (const field of options.preserve) {\n if (field in existing) {\n result[field] = existing[field];\n }\n }\n return result as T;\n });\n\n return batchUpsert(supabase, table, merged, options);\n}\n"]}
@@ -14,7 +14,5 @@
14
14
  * branchId,
15
15
  * );
16
16
  */
17
- export function withBranchFilter<T>(query: T, branchId?: string | null): T {
18
- if (!branchId || branchId === "all") return query;
19
- return (query as any).eq("branch_id", branchId) as T;
20
- }
17
+ export declare function withBranchFilter<T>(query: T, branchId?: string | null): T;
18
+ //# sourceMappingURL=with-org-branch-filter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-org-branch-filter.d.ts","sourceRoot":"","sources":["../src/with-org-branch-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,CAGzE"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Conditionally applies a branch_id filter to any Supabase query builder.
3
+ * Handles the `"all"` sentinel internally — treats it the same as
4
+ * `null`/`undefined` (no-op). Callers never need to normalize `"all"`
5
+ * before calling this function.
6
+ *
7
+ * @param query - Any Supabase query builder
8
+ * @param branchId - Branch ID to filter by, or `"all"`/`null`/`undefined` for no filter
9
+ * @returns The same query (possibly with `.eq("branch_id", branchId)` applied)
10
+ *
11
+ * @example
12
+ * const { data } = await withBranchFilter(
13
+ * supabase.from("work_orders").select("id").eq("organization_id", orgId),
14
+ * branchId,
15
+ * );
16
+ */
17
+ export function withBranchFilter(query, branchId) {
18
+ if (!branchId || branchId === "all")
19
+ return query;
20
+ return query.eq("branch_id", branchId);
21
+ }
22
+ //# sourceMappingURL=with-org-branch-filter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-org-branch-filter.js","sourceRoot":"","sources":["../src/with-org-branch-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAI,KAAQ,EAAE,QAAwB;IACpE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAClD,OAAQ,KAAa,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAM,CAAC;AACvD,CAAC","sourcesContent":["/**\n * Conditionally applies a branch_id filter to any Supabase query builder.\n * Handles the `\"all\"` sentinel internally — treats it the same as\n * `null`/`undefined` (no-op). Callers never need to normalize `\"all\"`\n * before calling this function.\n *\n * @param query - Any Supabase query builder\n * @param branchId - Branch ID to filter by, or `\"all\"`/`null`/`undefined` for no filter\n * @returns The same query (possibly with `.eq(\"branch_id\", branchId)` applied)\n *\n * @example\n * const { data } = await withBranchFilter(\n * supabase.from(\"work_orders\").select(\"id\").eq(\"organization_id\", orgId),\n * branchId,\n * );\n */\nexport function withBranchFilter<T>(query: T, branchId?: string | null): T {\n if (!branchId || branchId === \"all\") return query;\n return (query as any).eq(\"branch_id\", branchId) as T;\n}\n"]}
@@ -18,7 +18,5 @@
18
18
  * const q = withOrgScope(supabase.from("work_orders").select("*"), orgId);
19
19
  * const { data } = await withBranchFilter(q, branchId);
20
20
  */
21
- export function withOrgScope<T>(query: T, orgId?: string | null): T {
22
- if (!orgId) return query;
23
- return (query as any).eq("organization_id", orgId) as T;
24
- }
21
+ export declare function withOrgScope<T>(query: T, orgId?: string | null): T;
22
+ //# sourceMappingURL=with-org-scope.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-org-scope.d.ts","sourceRoot":"","sources":["../src/with-org-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,CAGlE"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Applies an organization_id filter to any Supabase query builder.
3
+ *
4
+ * Safe to chain — no-op when orgId is empty/null.
5
+ *
6
+ * @param query - Any Supabase query builder
7
+ * @param orgId - Organization ID to filter by (empty/null skips the filter)
8
+ * @returns The same query with `.eq("organization_id", orgId)` applied
9
+ *
10
+ * @example
11
+ * const { data } = await withOrgScope(
12
+ * supabase.from("work_orders").select("*"),
13
+ * orgId,
14
+ * );
15
+ *
16
+ * @example
17
+ * // Chained with withBranchFilter
18
+ * const q = withOrgScope(supabase.from("work_orders").select("*"), orgId);
19
+ * const { data } = await withBranchFilter(q, branchId);
20
+ */
21
+ export function withOrgScope(query, orgId) {
22
+ if (!orgId)
23
+ return query;
24
+ return query.eq("organization_id", orgId);
25
+ }
26
+ //# sourceMappingURL=with-org-scope.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-org-scope.js","sourceRoot":"","sources":["../src/with-org-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAI,KAAQ,EAAE,KAAqB;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAQ,KAAa,CAAC,EAAE,CAAC,iBAAiB,EAAE,KAAK,CAAM,CAAC;AAC1D,CAAC","sourcesContent":["/**\n * Applies an organization_id filter to any Supabase query builder.\n *\n * Safe to chain — no-op when orgId is empty/null.\n *\n * @param query - Any Supabase query builder\n * @param orgId - Organization ID to filter by (empty/null skips the filter)\n * @returns The same query with `.eq(\"organization_id\", orgId)` applied\n *\n * @example\n * const { data } = await withOrgScope(\n * supabase.from(\"work_orders\").select(\"*\"),\n * orgId,\n * );\n *\n * @example\n * // Chained with withBranchFilter\n * const q = withOrgScope(supabase.from(\"work_orders\").select(\"*\"), orgId);\n * const { data } = await withBranchFilter(q, branchId);\n */\nexport function withOrgScope<T>(query: T, orgId?: string | null): T {\n if (!orgId) return query;\n return (query as any).eq(\"organization_id\", orgId) as T;\n}\n"]}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Applies pagination (range/limit) to any Supabase query builder.
3
+ *
4
+ * @param query - Any Supabase query builder
5
+ * @param page - 1-based page number (default: 1)
6
+ * @param pageSize - Items per page (default: 20, max: 1000)
7
+ * @returns The same query with `.range()` applied
8
+ *
9
+ * @example
10
+ * const { data } = await withPagination(
11
+ * supabase.from("work_orders").select("*").eq("organization_id", orgId),
12
+ * 2, // page
13
+ * 25, // pageSize
14
+ * );
15
+ */
16
+ export declare function withPagination<T>(query: T, page?: number, pageSize?: number): T;
17
+ //# sourceMappingURL=with-pagination.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-pagination.d.ts","sourceRoot":"","sources":["../src/with-pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,CAAC,CAMH"}
@@ -13,14 +13,11 @@
13
13
  * 25, // pageSize
14
14
  * );
15
15
  */
16
- export function withPagination<T>(
17
- query: T,
18
- page?: number,
19
- pageSize?: number,
20
- ): T {
21
- const p = Math.max(1, page ?? 1);
22
- const ps = Math.min(Math.max(1, pageSize ?? 20), 1000);
23
- const from = (p - 1) * ps;
24
- const to = from + ps - 1;
25
- return (query as any).range(from, to) as T;
16
+ export function withPagination(query, page, pageSize) {
17
+ const p = Math.max(1, page ?? 1);
18
+ const ps = Math.min(Math.max(1, pageSize ?? 20), 1000);
19
+ const from = (p - 1) * ps;
20
+ const to = from + ps - 1;
21
+ return query.range(from, to);
26
22
  }
23
+ //# sourceMappingURL=with-pagination.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"with-pagination.js","sourceRoot":"","sources":["../src/with-pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAQ,EACR,IAAa,EACb,QAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IACzB,OAAQ,KAAa,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAM,CAAC;AAC7C,CAAC","sourcesContent":["/**\n * Applies pagination (range/limit) to any Supabase query builder.\n *\n * @param query - Any Supabase query builder\n * @param page - 1-based page number (default: 1)\n * @param pageSize - Items per page (default: 20, max: 1000)\n * @returns The same query with `.range()` applied\n *\n * @example\n * const { data } = await withPagination(\n * supabase.from(\"work_orders\").select(\"*\").eq(\"organization_id\", orgId),\n * 2, // page\n * 25, // pageSize\n * );\n */\nexport function withPagination<T>(\n query: T,\n page?: number,\n pageSize?: number,\n): T {\n const p = Math.max(1, page ?? 1);\n const ps = Math.min(Math.max(1, pageSize ?? 20), 1000);\n const from = (p - 1) * ps;\n const to = from + ps - 1;\n return (query as any).range(from, to) as T;\n}\n"]}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Cloudflare Workers AI client — free edge inference (10K Neurons/day).
3
+ *
4
+ * Env vars required:
5
+ * CF_ACCOUNT_ID — Cloudflare account ID
6
+ * CF_AI_API_TOKEN — API token with Workers AI:Read permission
7
+ *
8
+ * Available models (examples):
9
+ * Text: @cf/meta/llama-3.1-8b-instruct-fp8-fast
10
+ * Embedding: @cf/baai/bge-base-en-v1.5
11
+ * Image: @cf/black-forest-labs/FLUX-1-schnell
12
+ * Audio: @cf/openai/whisper
13
+ *
14
+ * Full catalog: https://developers.cloudflare.com/workers-ai/models/
15
+ */
16
+ interface ChatMessage {
17
+ role: "system" | "user" | "assistant";
18
+ content: string;
19
+ }
20
+ /**
21
+ * Run a non-streaming text completion.
22
+ */
23
+ export declare function workersAIComplete(model: string, messages: ChatMessage[]): Promise<string>;
24
+ /**
25
+ * Run a streaming text completion — returns an async iterable of text chunks.
26
+ */
27
+ export declare function workersAIStream(model: string, messages: ChatMessage[]): Promise<ReadableStream<string>>;
28
+ /**
29
+ * Generate embeddings for text (useful for semantic search).
30
+ */
31
+ export declare function workersAIEmbed(model: string, texts: string[]): Promise<number[][]>;
32
+ export {};
33
+ //# sourceMappingURL=workers-ai.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workers-ai.d.ts","sourceRoot":"","sources":["../src/workers-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,UAAU,WAAW;IACnB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAuBD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CA8CjC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CA8BrB"}
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Cloudflare Workers AI client — free edge inference (10K Neurons/day).
3
+ *
4
+ * Env vars required:
5
+ * CF_ACCOUNT_ID — Cloudflare account ID
6
+ * CF_AI_API_TOKEN — API token with Workers AI:Read permission
7
+ *
8
+ * Available models (examples):
9
+ * Text: @cf/meta/llama-3.1-8b-instruct-fp8-fast
10
+ * Embedding: @cf/baai/bge-base-en-v1.5
11
+ * Image: @cf/black-forest-labs/FLUX-1-schnell
12
+ * Audio: @cf/openai/whisper
13
+ *
14
+ * Full catalog: https://developers.cloudflare.com/workers-ai/models/
15
+ */
16
+ function getConfig() {
17
+ const accountId = process.env.CF_ACCOUNT_ID;
18
+ const apiToken = process.env.CF_AI_API_TOKEN;
19
+ if (!accountId || !apiToken) {
20
+ throw new Error("Workers AI not configured. Set CF_ACCOUNT_ID and CF_AI_API_TOKEN.");
21
+ }
22
+ return { accountId, apiToken };
23
+ }
24
+ /**
25
+ * Run a non-streaming text completion.
26
+ */
27
+ export async function workersAIComplete(model, messages) {
28
+ const { accountId, apiToken } = getConfig();
29
+ const res = await fetch(`https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`, {
30
+ method: "POST",
31
+ headers: {
32
+ Authorization: `Bearer ${apiToken}`,
33
+ "Content-Type": "application/json",
34
+ },
35
+ body: JSON.stringify({ messages }),
36
+ });
37
+ if (!res.ok) {
38
+ const text = await res.text();
39
+ throw new Error(`Workers AI error ${res.status}: ${text}`);
40
+ }
41
+ const data = (await res.json());
42
+ if (!data.success) {
43
+ throw new Error(`Workers AI failed: ${data.errors.join(", ")}`);
44
+ }
45
+ return data.result.response;
46
+ }
47
+ /**
48
+ * Run a streaming text completion — returns an async iterable of text chunks.
49
+ */
50
+ export async function workersAIStream(model, messages) {
51
+ const { accountId, apiToken } = getConfig();
52
+ const res = await fetch(`https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`, {
53
+ method: "POST",
54
+ headers: {
55
+ Authorization: `Bearer ${apiToken}`,
56
+ "Content-Type": "application/json",
57
+ },
58
+ body: JSON.stringify({ messages, stream: true }),
59
+ });
60
+ if (!res.ok) {
61
+ const text = await res.text();
62
+ throw new Error(`Workers AI error ${res.status}: ${text}`);
63
+ }
64
+ const reader = res.body.getReader();
65
+ const decoder = new TextDecoder();
66
+ return new ReadableStream({
67
+ async pull(controller) {
68
+ const { done, value } = await reader.read();
69
+ if (done) {
70
+ controller.close();
71
+ return;
72
+ }
73
+ const text = decoder.decode(value, { stream: true });
74
+ // NDJSON: each line is a JSON object
75
+ for (const line of text.split("\n")) {
76
+ if (!line.trim())
77
+ continue;
78
+ try {
79
+ const chunk = JSON.parse(line);
80
+ if (chunk.response) {
81
+ controller.enqueue(chunk.response);
82
+ }
83
+ }
84
+ catch {
85
+ // skip malformed lines
86
+ }
87
+ }
88
+ },
89
+ });
90
+ }
91
+ /**
92
+ * Generate embeddings for text (useful for semantic search).
93
+ */
94
+ export async function workersAIEmbed(model, texts) {
95
+ const { accountId, apiToken } = getConfig();
96
+ const res = await fetch(`https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`, {
97
+ method: "POST",
98
+ headers: {
99
+ Authorization: `Bearer ${apiToken}`,
100
+ "Content-Type": "application/json",
101
+ },
102
+ body: JSON.stringify({ text: texts }),
103
+ });
104
+ if (!res.ok) {
105
+ const text = await res.text();
106
+ throw new Error(`Workers AI embed error ${res.status}: ${text}`);
107
+ }
108
+ const data = (await res.json());
109
+ if (!data.success) {
110
+ throw new Error("Workers AI embedding failed");
111
+ }
112
+ return data.result.data;
113
+ }
114
+ //# sourceMappingURL=workers-ai.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workers-ai.js","sourceRoot":"","sources":["../src/workers-ai.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cloudflare Workers AI client — free edge inference (10K Neurons/day).\n *\n * Env vars required:\n * CF_ACCOUNT_ID — Cloudflare account ID\n * CF_AI_API_TOKEN — API token with Workers AI:Read permission\n *\n * Available models (examples):\n * Text: @cf/meta/llama-3.1-8b-instruct-fp8-fast\n * Embedding: @cf/baai/bge-base-en-v1.5\n * Image: @cf/black-forest-labs/FLUX-1-schnell\n * Audio: @cf/openai/whisper\n *\n * Full catalog: https://developers.cloudflare.com/workers-ai/models/\n */\n\ninterface WorkersAIConfig {\n accountId?: string;\n apiToken?: string;\n}\n\ninterface ChatMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: string;\n}\n\ninterface ChatCompletionResponse {\n result: { response: string };\n success: boolean;\n errors: string[];\n}\n\ninterface StreamChunk {\n response?: string;\n}\n\nfunction getConfig(): Required<WorkersAIConfig> {\n const accountId = process.env.CF_ACCOUNT_ID;\n const apiToken = process.env.CF_AI_API_TOKEN;\n\n if (!accountId || !apiToken) {\n throw new Error(\"Workers AI not configured. Set CF_ACCOUNT_ID and CF_AI_API_TOKEN.\");\n }\n\n return { accountId, apiToken };\n}\n\n/**\n * Run a non-streaming text completion.\n */\nexport async function workersAIComplete(\n model: string,\n messages: ChatMessage[],\n): Promise<string> {\n const { accountId, apiToken } = getConfig();\n\n const res = await fetch(\n `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`,\n {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ messages }),\n },\n );\n\n if (!res.ok) {\n const text = await res.text();\n throw new Error(`Workers AI error ${res.status}: ${text}`);\n }\n\n const data = (await res.json()) as ChatCompletionResponse;\n if (!data.success) {\n throw new Error(`Workers AI failed: ${data.errors.join(\", \")}`);\n }\n\n return data.result.response;\n}\n\n/**\n * Run a streaming text completion — returns an async iterable of text chunks.\n */\nexport async function workersAIStream(\n model: string,\n messages: ChatMessage[],\n): Promise<ReadableStream<string>> {\n const { accountId, apiToken } = getConfig();\n\n const res = await fetch(\n `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`,\n {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ messages, stream: true }),\n },\n );\n\n if (!res.ok) {\n const text = await res.text();\n throw new Error(`Workers AI error ${res.status}: ${text}`);\n }\n\n const reader = res.body!.getReader();\n const decoder = new TextDecoder();\n\n return new ReadableStream({\n async pull(controller) {\n const { done, value } = await reader.read();\n if (done) {\n controller.close();\n return;\n }\n\n const text = decoder.decode(value, { stream: true });\n // NDJSON: each line is a JSON object\n for (const line of text.split(\"\\n\")) {\n if (!line.trim()) continue;\n try {\n const chunk = JSON.parse(line) as StreamChunk;\n if (chunk.response) {\n controller.enqueue(chunk.response);\n }\n } catch {\n // skip malformed lines\n }\n }\n },\n });\n}\n\n/**\n * Generate embeddings for text (useful for semantic search).\n */\nexport async function workersAIEmbed(\n model: string,\n texts: string[],\n): Promise<number[][]> {\n const { accountId, apiToken } = getConfig();\n\n const res = await fetch(\n `https://api.cloudflare.com/client/v4/accounts/${accountId}/ai/run/${model}`,\n {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${apiToken}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({ text: texts }),\n },\n );\n\n if (!res.ok) {\n const text = await res.text();\n throw new Error(`Workers AI embed error ${res.status}: ${text}`);\n }\n\n const data = (await res.json()) as {\n result: { data: number[][] };\n success: boolean;\n };\n\n if (!data.success) {\n throw new Error(\"Workers AI embedding failed\");\n }\n\n return data.result.data;\n}\n"]}