@hasna/contacts 0.6.22 → 0.6.27

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 (185) hide show
  1. package/README.md +82 -6
  2. package/dist/cli/commands/advanced.d.ts.map +1 -1
  3. package/dist/cli/commands/audience.d.ts +18 -0
  4. package/dist/cli/commands/audience.d.ts.map +1 -0
  5. package/dist/cli/commands/core.d.ts.map +1 -1
  6. package/dist/cli/commands/crm.d.ts.map +1 -1
  7. package/dist/cli/index.js +9446 -5681
  8. package/dist/cli/storage.d.ts.map +1 -1
  9. package/dist/cloud/http-storage.d.ts +88 -0
  10. package/dist/cloud/http-storage.d.ts.map +1 -0
  11. package/dist/db/audiences.d.ts +51 -0
  12. package/dist/db/audiences.d.ts.map +1 -0
  13. package/dist/db/companies.d.ts.map +1 -1
  14. package/dist/db/contacts.d.ts.map +1 -1
  15. package/dist/db/database.d.ts +1 -2
  16. package/dist/db/database.d.ts.map +1 -1
  17. package/dist/db/paths.d.ts +3 -0
  18. package/dist/db/paths.d.ts.map +1 -0
  19. package/dist/db/pg-migrations.d.ts.map +1 -1
  20. package/dist/db/storage.d.ts +1 -1
  21. package/dist/db/storage.d.ts.map +1 -1
  22. package/dist/db/tags.d.ts.map +1 -1
  23. package/dist/db/tombstones.d.ts +19 -0
  24. package/dist/db/tombstones.d.ts.map +1 -0
  25. package/dist/generated/storage-kit/health.d.ts +20 -0
  26. package/dist/generated/storage-kit/health.d.ts.map +1 -0
  27. package/dist/generated/storage-kit/index.d.ts +8 -0
  28. package/dist/generated/storage-kit/index.d.ts.map +1 -0
  29. package/dist/generated/storage-kit/migrations.d.ts +48 -0
  30. package/dist/generated/storage-kit/migrations.d.ts.map +1 -0
  31. package/dist/generated/storage-kit/mode.d.ts +48 -0
  32. package/dist/generated/storage-kit/mode.d.ts.map +1 -0
  33. package/dist/generated/storage-kit/pool.d.ts +34 -0
  34. package/dist/generated/storage-kit/pool.d.ts.map +1 -0
  35. package/dist/generated/storage-kit/query.d.ts +36 -0
  36. package/dist/generated/storage-kit/query.d.ts.map +1 -0
  37. package/dist/generated/storage-kit/tls.d.ts +26 -0
  38. package/dist/generated/storage-kit/tls.d.ts.map +1 -0
  39. package/dist/index.d.ts +6 -76
  40. package/dist/index.d.ts.map +1 -1
  41. package/dist/index.js +3876 -2787
  42. package/dist/lib/audience-contract.d.ts +215 -0
  43. package/dist/lib/audience-contract.d.ts.map +1 -0
  44. package/dist/lib/mailery-sync.d.ts +46 -0
  45. package/dist/lib/mailery-sync.d.ts.map +1 -0
  46. package/dist/lib/package-version.d.ts +6 -0
  47. package/dist/lib/package-version.d.ts.map +1 -0
  48. package/dist/mcp/handlers/advanced.d.ts +5 -0
  49. package/dist/mcp/handlers/advanced.d.ts.map +1 -1
  50. package/dist/mcp/handlers/audience.d.ts +9 -0
  51. package/dist/mcp/handlers/audience.d.ts.map +1 -0
  52. package/dist/mcp/handlers/core.d.ts +4 -0
  53. package/dist/mcp/handlers/core.d.ts.map +1 -1
  54. package/dist/mcp/handlers/crm.d.ts +5 -0
  55. package/dist/mcp/handlers/crm.d.ts.map +1 -1
  56. package/dist/mcp/handlers/index.d.ts.map +1 -1
  57. package/dist/mcp/index.js +5843 -4045
  58. package/dist/mcp/storage-tools.d.ts.map +1 -1
  59. package/dist/mcp/tools.d.ts +252 -0
  60. package/dist/mcp/tools.d.ts.map +1 -1
  61. package/dist/sdk/index.d.ts +16 -0
  62. package/dist/sdk/index.d.ts.map +1 -0
  63. package/dist/sdk/index.js +173 -0
  64. package/dist/sdk/v1.generated.d.ts +189 -0
  65. package/dist/sdk/v1.generated.d.ts.map +1 -0
  66. package/dist/server/cloud.d.ts +51 -0
  67. package/dist/server/cloud.d.ts.map +1 -0
  68. package/dist/server/index.js +8791 -4916
  69. package/dist/server/openapi.d.ts +708 -0
  70. package/dist/server/openapi.d.ts.map +1 -0
  71. package/dist/server/pg-store.d.ts +57 -0
  72. package/dist/server/pg-store.d.ts.map +1 -0
  73. package/dist/server/security.d.ts +24 -0
  74. package/dist/server/security.d.ts.map +1 -0
  75. package/dist/server/serve.d.ts +8 -1
  76. package/dist/server/serve.d.ts.map +1 -1
  77. package/dist/server/v1.d.ts +6 -0
  78. package/dist/server/v1.d.ts.map +1 -0
  79. package/dist/store/index.d.ts +383 -0
  80. package/dist/store/index.d.ts.map +1 -0
  81. package/dist/types/index.d.ts +96 -0
  82. package/dist/types/index.d.ts.map +1 -1
  83. package/hasna.contract.json +32 -0
  84. package/migrations/0001_core_schema.sql +162 -0
  85. package/migrations/0002_contact_fields_groups.sql +22 -0
  86. package/migrations/0003_status_archiving.sql +17 -0
  87. package/migrations/0004_company_relationships.sql +16 -0
  88. package/migrations/0005_contact_projects.sql +19 -0
  89. package/migrations/0006_contact_notes.sql +14 -0
  90. package/migrations/0007_entities_vendor_tasks.sql +91 -0
  91. package/migrations/0008_deals_events.sql +36 -0
  92. package/migrations/0009_history_learnings_coordination.sql +122 -0
  93. package/migrations/0010_documents_health.sql +38 -0
  94. package/migrations/0011_feedback.sql +14 -0
  95. package/migrations/0012_audiences_consent_suppressions.sql +38 -0
  96. package/migrations/9001_api_keys.sql +18 -0
  97. package/package.json +19 -4
  98. package/dist/cli/storage-contract.test.d.ts +0 -2
  99. package/dist/cli/storage-contract.test.d.ts.map +0 -1
  100. package/dist/db/activity.test.d.ts +0 -2
  101. package/dist/db/activity.test.d.ts.map +0 -1
  102. package/dist/db/applications.test.d.ts +0 -2
  103. package/dist/db/applications.test.d.ts.map +0 -1
  104. package/dist/db/companies.test.d.ts +0 -2
  105. package/dist/db/companies.test.d.ts.map +0 -1
  106. package/dist/db/contact-tasks.test.d.ts +0 -2
  107. package/dist/db/contact-tasks.test.d.ts.map +0 -1
  108. package/dist/db/contacts.test.d.ts +0 -2
  109. package/dist/db/contacts.test.d.ts.map +0 -1
  110. package/dist/db/coordination.test.d.ts +0 -2
  111. package/dist/db/coordination.test.d.ts.map +0 -1
  112. package/dist/db/database.test.d.ts +0 -2
  113. package/dist/db/database.test.d.ts.map +0 -1
  114. package/dist/db/deals.test.d.ts +0 -2
  115. package/dist/db/deals.test.d.ts.map +0 -1
  116. package/dist/db/documents.test.d.ts +0 -2
  117. package/dist/db/documents.test.d.ts.map +0 -1
  118. package/dist/db/events.test.d.ts +0 -2
  119. package/dist/db/events.test.d.ts.map +0 -1
  120. package/dist/db/feedback.d.ts +0 -15
  121. package/dist/db/feedback.d.ts.map +0 -1
  122. package/dist/db/field-history.test.d.ts +0 -2
  123. package/dist/db/field-history.test.d.ts.map +0 -1
  124. package/dist/db/freshness.test.d.ts +0 -2
  125. package/dist/db/freshness.test.d.ts.map +0 -1
  126. package/dist/db/graph.test.d.ts +0 -2
  127. package/dist/db/graph.test.d.ts.map +0 -1
  128. package/dist/db/groups.test.d.ts +0 -2
  129. package/dist/db/groups.test.d.ts.map +0 -1
  130. package/dist/db/health.test.d.ts +0 -2
  131. package/dist/db/health.test.d.ts.map +0 -1
  132. package/dist/db/identity.test.d.ts +0 -2
  133. package/dist/db/identity.test.d.ts.map +0 -1
  134. package/dist/db/job-history.test.d.ts +0 -2
  135. package/dist/db/job-history.test.d.ts.map +0 -1
  136. package/dist/db/learnings.test.d.ts +0 -2
  137. package/dist/db/learnings.test.d.ts.map +0 -1
  138. package/dist/db/notes.test.d.ts +0 -2
  139. package/dist/db/notes.test.d.ts.map +0 -1
  140. package/dist/db/org-chart.test.d.ts +0 -2
  141. package/dist/db/org-chart.test.d.ts.map +0 -1
  142. package/dist/db/org-members.test.d.ts +0 -2
  143. package/dist/db/org-members.test.d.ts.map +0 -1
  144. package/dist/db/relationships.test.d.ts +0 -2
  145. package/dist/db/relationships.test.d.ts.map +0 -1
  146. package/dist/db/signals.test.d.ts +0 -2
  147. package/dist/db/signals.test.d.ts.map +0 -1
  148. package/dist/db/sqlite-adapter.test.d.ts +0 -2
  149. package/dist/db/sqlite-adapter.test.d.ts.map +0 -1
  150. package/dist/db/storage.test.d.ts +0 -2
  151. package/dist/db/storage.test.d.ts.map +0 -1
  152. package/dist/db/tags.test.d.ts +0 -2
  153. package/dist/db/tags.test.d.ts.map +0 -1
  154. package/dist/db/vendor-comms.test.d.ts +0 -2
  155. package/dist/db/vendor-comms.test.d.ts.map +0 -1
  156. package/dist/lib/audit.test.d.ts +0 -2
  157. package/dist/lib/audit.test.d.ts.map +0 -1
  158. package/dist/lib/brief.test.d.ts +0 -2
  159. package/dist/lib/brief.test.d.ts.map +0 -1
  160. package/dist/lib/config.test.d.ts +0 -2
  161. package/dist/lib/config.test.d.ts.map +0 -1
  162. package/dist/lib/dedup.test.d.ts +0 -2
  163. package/dist/lib/dedup.test.d.ts.map +0 -1
  164. package/dist/lib/export.test.d.ts +0 -2
  165. package/dist/lib/export.test.d.ts.map +0 -1
  166. package/dist/lib/gmail-import.test.d.ts +0 -2
  167. package/dist/lib/gmail-import.test.d.ts.map +0 -1
  168. package/dist/lib/google-contacts.test.d.ts +0 -2
  169. package/dist/lib/google-contacts.test.d.ts.map +0 -1
  170. package/dist/lib/import.test.d.ts +0 -2
  171. package/dist/lib/import.test.d.ts.map +0 -1
  172. package/dist/lib/signature-parser.test.d.ts +0 -2
  173. package/dist/lib/signature-parser.test.d.ts.map +0 -1
  174. package/dist/lib/stats.test.d.ts +0 -2
  175. package/dist/lib/stats.test.d.ts.map +0 -1
  176. package/dist/lib/timeline.test.d.ts +0 -2
  177. package/dist/lib/timeline.test.d.ts.map +0 -1
  178. package/dist/lib/upcoming.test.d.ts +0 -2
  179. package/dist/lib/upcoming.test.d.ts.map +0 -1
  180. package/dist/mcp/http.test.d.ts +0 -2
  181. package/dist/mcp/http.test.d.ts.map +0 -1
  182. package/dist/mcp/mcp.test.d.ts +0 -2
  183. package/dist/mcp/mcp.test.d.ts.map +0 -1
  184. package/dist/mcp/storage-contract.test.d.ts +0 -2
  185. package/dist/mcp/storage-contract.test.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cli/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8GzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc9D"}
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cli/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2DzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqD9D"}
@@ -0,0 +1,88 @@
1
+ export type Env = Record<string, string | undefined>;
2
+ /** Normalize a base URL to `<origin>/v1`. */
3
+ export declare function toV1BaseUrl(apiUrl: string): string;
4
+ export type ClientTransportKind = "local" | "cloud-http";
5
+ export interface ClientTransportResolution {
6
+ transport: ClientTransportKind;
7
+ mode: "local" | "cloud";
8
+ modeSource: string;
9
+ baseUrl: string | null;
10
+ apiKeyPresent: boolean;
11
+ apiKeySource: string | null;
12
+ misconfigured: boolean;
13
+ warning: string | null;
14
+ }
15
+ /**
16
+ * Decide whether this client should read/write from the cloud API or locally.
17
+ * Cloud-http IFF the resolved mode is cloud/self_hosted AND an API key is set.
18
+ * If cloud is requested but the key is missing/invalid, returns local with
19
+ * `misconfigured: true` so callers can hard-fail instead of drifting.
20
+ */
21
+ export declare function resolveClientTransport(name: string, env?: Env): ClientTransportResolution;
22
+ /** Thrown when a cloud HTTP request returns a non-2xx status. */
23
+ export declare class HasnaHttpError extends Error {
24
+ readonly status: number;
25
+ readonly method: string;
26
+ readonly path: string;
27
+ readonly body: unknown;
28
+ constructor(method: string, path: string, status: number, body: unknown);
29
+ }
30
+ type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
31
+ export type QueryParams = Record<string, string | number | boolean | null | undefined>;
32
+ export interface RequestOptions {
33
+ query?: QueryParams;
34
+ idempotencyKey?: string;
35
+ timeoutMs?: number;
36
+ headers?: Record<string, string>;
37
+ signal?: AbortSignal;
38
+ retries?: number;
39
+ }
40
+ export interface HttpTransport {
41
+ readonly baseUrl: string;
42
+ request<T = unknown>(method: string, path: string, body?: unknown, opts?: RequestOptions): Promise<T>;
43
+ get<T = unknown>(path: string, opts?: RequestOptions): Promise<T>;
44
+ post<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<T>;
45
+ put<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<T>;
46
+ patch<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<T>;
47
+ del<T = unknown>(path: string, body?: unknown, opts?: RequestOptions): Promise<T>;
48
+ }
49
+ interface TransportOptions {
50
+ name: string;
51
+ baseUrl: string;
52
+ apiKey: string;
53
+ fetchImpl?: FetchLike;
54
+ timeoutMs?: number;
55
+ retries?: number;
56
+ }
57
+ export declare function createHttpTransport(options: TransportOptions): HttpTransport;
58
+ export interface StorageClient {
59
+ readonly name: string;
60
+ readonly baseUrl: string;
61
+ readonly transport: HttpTransport;
62
+ list<T = unknown>(resource: string, opts?: RequestOptions): Promise<T>;
63
+ get<T = unknown>(resource: string, id: string, opts?: RequestOptions): Promise<T | null>;
64
+ create<T = unknown>(resource: string, body: unknown, opts?: RequestOptions): Promise<T>;
65
+ update<T = unknown>(resource: string, id: string, patch: unknown, opts?: RequestOptions & {
66
+ method?: "PATCH" | "PUT";
67
+ }): Promise<T>;
68
+ delete<T = unknown>(resource: string, id: string, opts?: RequestOptions): Promise<T>;
69
+ }
70
+ export declare function createStorageClient(name: string, transport: HttpTransport): StorageClient;
71
+ export type ResolveStorageClientResult = {
72
+ transport: "local";
73
+ client: null;
74
+ resolution: ClientTransportResolution;
75
+ } | {
76
+ transport: "cloud-http";
77
+ client: StorageClient;
78
+ resolution: ClientTransportResolution;
79
+ };
80
+ /**
81
+ * The one call the app's storage resolver makes. Reads the client-flip env for
82
+ * `name`; returns a ready cloud client when self_hosted + API key are set, else
83
+ * `{ transport: 'local', client: null }`. Throws if cloud was requested but is
84
+ * misconfigured (so callers never silently read the wrong dataset).
85
+ */
86
+ export declare function resolveStorageClient(name: string, env?: Env): ResolveStorageClientResult;
87
+ export {};
88
+ //# sourceMappingURL=http-storage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-storage.d.ts","sourceRoot":"","sources":["../../src/cloud/http-storage.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Audiences, per-channel consent, and suppression storage (distribution plan).
3
+ *
4
+ * Audience segment definitions follow hasna.audience.v1: predicates over
5
+ * contact tags, contact attributes (columns + custom fields), and group
6
+ * membership, combined with match=all|any. Resolution honors per-channel
7
+ * consent, the audience consent policy, suppression entries, do_not_contact,
8
+ * and archived status.
9
+ */
10
+ import type { ContactsDatabase } from "./database.js";
11
+ import type { Audience, AudienceChannel, AudiencePredicate, AudienceResolution, ConsentStatus, ContactConsent, ContactSuppression, CreateAudienceInput, UpdateAudienceInput } from "../types/index.js";
12
+ export declare function createAudience(input: CreateAudienceInput, db?: ContactsDatabase): Audience;
13
+ /** Look up by internal id or by audience_id slug. */
14
+ export declare function getAudience(idOrSlug: string, db?: ContactsDatabase): Audience;
15
+ export declare function listAudiences(db?: ContactsDatabase): Audience[];
16
+ export declare function updateAudience(idOrSlug: string, input: UpdateAudienceInput, db?: ContactsDatabase): Audience;
17
+ export declare function deleteAudience(idOrSlug: string, db?: ContactsDatabase): void;
18
+ export declare function markAudienceSuppressionSynced(idOrSlug: string, at: string, db?: ContactsDatabase): Audience;
19
+ export declare function setContactConsent(contactId: string, channel: AudienceChannel, status: ConsentStatus, source?: string, db?: ContactsDatabase): ContactConsent;
20
+ export declare function getContactConsent(contactId: string, channel: AudienceChannel, db?: ContactsDatabase): ContactConsent | null;
21
+ export declare function listContactConsent(contactId: string, db?: ContactsDatabase): ContactConsent[];
22
+ export interface SuppressInput {
23
+ channel: AudienceChannel;
24
+ address: string;
25
+ contact_id?: string;
26
+ reason?: string;
27
+ }
28
+ export declare function suppressAddress(input: SuppressInput, db?: ContactsDatabase): ContactSuppression;
29
+ export declare function unsuppressAddress(channel: AudienceChannel, address: string, db?: ContactsDatabase): void;
30
+ export declare function listSuppressions(options?: {
31
+ channel?: AudienceChannel;
32
+ unsyncedOnly?: boolean;
33
+ }, db?: ContactsDatabase): ContactSuppression[];
34
+ export declare function markSuppressionsSynced(ids: string[], at: string, db?: ContactsDatabase): number;
35
+ interface CandidateRow {
36
+ id: string;
37
+ display_name: string;
38
+ archived: number;
39
+ do_not_contact: number;
40
+ custom_fields: string;
41
+ [key: string]: unknown;
42
+ }
43
+ export declare function evaluateAudiencePredicate(d: ContactsDatabase, row: CandidateRow, predicate: AudiencePredicate): boolean;
44
+ export declare function matchAudienceContacts(audience: Audience, db?: ContactsDatabase): CandidateRow[];
45
+ /**
46
+ * Resolve an audience to per-channel recipients, honoring consent policy,
47
+ * per-channel consent status, suppressions, and do_not_contact.
48
+ */
49
+ export declare function resolveAudience(idOrSlug: string, channel: AudienceChannel, db?: ContactsDatabase): AudienceResolution;
50
+ export {};
51
+ //# sourceMappingURL=audiences.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audiences.d.ts","sourceRoot":"","sources":["../../src/db/audiences.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../src/db/companies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAGV,kBAAkB,EAElB,kBAAkB,EAClB,OAAO,EAGP,kBAAkB,EAUlB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAwG3B,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAyClG;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAKhF;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,kBAAuB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiDtI;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CA4B9G;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAQrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,CAU1F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAoBxF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAQpF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAQtF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE3G"}
1
+ {"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../src/db/companies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAGV,kBAAkB,EAElB,kBAAkB,EAClB,OAAO,EAGP,kBAAkB,EAUlB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAyG3B,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAyClG;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAKhF;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,kBAAuB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiDtI;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CA4B9G;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CASrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,CAU1F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAoBxF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAQpF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAQtF;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG;IAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAE3G"}
@@ -1 +1 @@
1
- {"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/db/contacts.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/db/contacts.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,5 @@
1
1
  import { SqliteAdapter } from "./sqlite-adapter.js";
2
- export declare function getDataDir(): string;
3
- export declare function getDbPath(): string;
2
+ export { getDataDir, getDbPath } from "./paths.js";
4
3
  export type ContactsDatabase = SqliteAdapter;
5
4
  export declare function getDatabase(path?: string): ContactsDatabase;
6
5
  export declare function resetDatabase(): void;
@@ -1 +1 @@
1
- {"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,wBAAgB,UAAU,IAAI,MAAM,CAkBnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAIlC;AA4hBD,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAI7C,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAU3D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}
1
+ {"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/db/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAylBnD,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAI7C,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAW3D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}
@@ -0,0 +1,3 @@
1
+ export declare function getDataDir(): string;
2
+ export declare function getDbPath(): string;
3
+ //# sourceMappingURL=paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/db/paths.ts"],"names":[],"mappings":"AAgBA,wBAAgB,UAAU,IAAI,MAAM,CAuBnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAIlC"}
@@ -1 +1 @@
1
- {"version":3,"file":"pg-migrations.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,EAkjBjC,CAAC"}
1
+ {"version":3,"file":"pg-migrations.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,EAymBjC,CAAC"}
@@ -10,6 +10,6 @@ export interface ContactsStorageStatus {
10
10
  db_path: string;
11
11
  tables: StorageTableStatus[];
12
12
  }
13
- export declare const CONTACTS_STORAGE_TABLES: readonly ["companies", "contacts", "tags", "contact_tags", "company_tags", "emails", "phones", "addresses", "social_profiles", "contact_relationships", "activity_log", "webhooks", "contacts_fts", "groups", "contact_groups", "company_groups", "company_relationships", "contact_projects", "contact_notes", "org_members", "vendor_communications", "contact_tasks", "applications", "deals", "events", "contact_field_history", "job_history", "contact_learnings", "contact_locks", "contact_agent_activity", "contact_identities", "contact_field_confidence", "org_chart_edges", "deal_contact_roles", "contact_embeddings", "contact_documents", "contact_health", "feedback"];
13
+ export declare const CONTACTS_STORAGE_TABLES: readonly ["companies", "contacts", "tags", "contact_tags", "company_tags", "emails", "phones", "addresses", "social_profiles", "contact_relationships", "activity_log", "webhooks", "contacts_fts", "groups", "contact_groups", "company_groups", "company_relationships", "contact_projects", "contact_notes", "org_members", "vendor_communications", "contact_tasks", "applications", "deals", "events", "contact_field_history", "job_history", "contact_learnings", "contact_locks", "contact_agent_activity", "contact_identities", "contact_field_confidence", "org_chart_edges", "deal_contact_roles", "contact_embeddings", "contact_documents", "contact_health", "feedback", "audiences", "contact_consent", "contact_suppressions"];
14
14
  export declare function getStorageStatus(db?: ContactsDatabase): ContactsStorageStatus;
15
15
  //# sourceMappingURL=storage.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/db/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,ypBAuC1B,CAAC;AAMX,wBAAgB,gBAAgB,CAAC,EAAE,GAAE,gBAAgC,GAAG,qBAAqB,CAkB5F"}
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/db/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,uBAAuB,itBA0C1B,CAAC;AAMX,wBAAgB,gBAAgB,CAAC,EAAE,GAAE,gBAAgC,GAAG,qBAAqB,CAkB5F"}
@@ -1 +1 @@
1
- {"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/db/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EACd,GAAG,EAEH,cAAc,EACf,MAAM,mBAAmB,CAAC;AAY3B,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAY3E;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAK7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAI5E;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,EAAE,CAGrD;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAuBvF;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAKjE;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAO7F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGlG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,EAAE,CA0BjF;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAO7F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGlG"}
1
+ {"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/db/tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,OAAO,EAEP,cAAc,EACd,GAAG,EAEH,cAAc,EACf,MAAM,mBAAmB,CAAC;AAa3B,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAY3E;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAK7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAI5E;AAED,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,EAAE,CAGrD;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAuBvF;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAMjE;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAO7F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGlG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,EAAE,CA0BjF;AAID,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAO7F;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAGlG"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Local delete-tracking tombstones.
3
+ *
4
+ * When a core row (contact / company / tag) is deleted, we record a tombstone in
5
+ * the on-box `_contacts_tombstones` table so a server-side sync/parity pull can
6
+ * see *what was deleted* (a plain absence can't be distinguished from "never
7
+ * existed"). This is a PURE local-table write inside the SQLite transport — it
8
+ * opens no network connection and never touches a Postgres DSN. The forbidden
9
+ * client-side DSN sync path (removed in the DSN-hardening commit) is unrelated;
10
+ * this only writes the local table the LocalStore already owns.
11
+ */
12
+ import type { ContactsDatabase } from "./database.js";
13
+ export type ContactsDeletableTable = "contacts" | "companies" | "tags";
14
+ export declare function recordTombstone(table: ContactsDeletableTable, rowId: string, options?: {
15
+ actor?: string;
16
+ reason?: string;
17
+ db?: ContactsDatabase;
18
+ }): void;
19
+ //# sourceMappingURL=tombstones.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tombstones.d.ts","sourceRoot":"","sources":["../../src/db/tombstones.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAEvE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACnE,IAAI,CAWN"}
@@ -0,0 +1,20 @@
1
+ import type { TypedQueryClient } from "./query.js";
2
+ import { type Migration, type MigrationRunnerOptions } from "./migrations.js";
3
+ export interface HealthResult {
4
+ ok: boolean;
5
+ /** Round-trip latency of the probe query, in milliseconds. */
6
+ latencyMs: number;
7
+ error?: string;
8
+ }
9
+ /** Cheap reachability probe: `SELECT 1`. Never throws — reports `ok: false`. */
10
+ export declare function checkHealth(client: TypedQueryClient): Promise<HealthResult>;
11
+ export interface ReadyResult extends HealthResult {
12
+ /** Migration ids that are defined but not yet applied. */
13
+ pendingMigrations: string[];
14
+ }
15
+ /**
16
+ * Readiness probe: reachable AND fully migrated. Reports `ok: false` with the
17
+ * list of pending migration ids when the schema is behind.
18
+ */
19
+ export declare function checkReady(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions): Promise<ReadyResult>;
20
+ //# sourceMappingURL=health.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/health.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE/F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAYjF;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,WAAW,CAAC,CAetB"}
@@ -0,0 +1,8 @@
1
+ export declare const KIT_VERSION = "0.4.2";
2
+ export * from "./mode.js";
3
+ export * from "./tls.js";
4
+ export * from "./query.js";
5
+ export * from "./pool.js";
6
+ export * from "./migrations.js";
7
+ export * from "./health.js";
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/index.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
@@ -0,0 +1,48 @@
1
+ import type { TypedQueryClient } from "./query.js";
2
+ /** Default ledger table name. Override per app if a legacy name exists. */
3
+ export declare const DEFAULT_MIGRATION_LEDGER_TABLE = "schema_migrations";
4
+ export interface Migration {
5
+ readonly id: string;
6
+ readonly sql: string;
7
+ readonly checksum: string;
8
+ }
9
+ export type MigrationState = "already_applied" | "pending";
10
+ export interface MigrationPlanItem {
11
+ readonly migration: Migration;
12
+ readonly state: MigrationState;
13
+ }
14
+ export interface AppliedMigration {
15
+ readonly id: string;
16
+ readonly checksum: string;
17
+ readonly appliedAt: string;
18
+ }
19
+ export interface MigrationResult {
20
+ readonly dryRun: boolean;
21
+ readonly applied: AppliedMigration[];
22
+ readonly plan: MigrationPlanItem[];
23
+ }
24
+ /** Stable sha256 checksum for a migration's SQL text. */
25
+ export declare function checksumSql(sql: string): string;
26
+ /** Freeze a migration definition, computing its checksum from the SQL. */
27
+ export declare function defineMigration(id: string, sql: string): Migration;
28
+ export interface MigrationRunnerOptions {
29
+ ledgerTable?: string;
30
+ }
31
+ export declare class MigrationLedger {
32
+ private readonly client;
33
+ private readonly migrations;
34
+ private readonly ledgerTable;
35
+ constructor(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions);
36
+ ensureLedger(): Promise<void>;
37
+ listApplied(): Promise<AppliedMigration[]>;
38
+ private readApplied;
39
+ /** Compute the migration plan and guard against drift/downgrade. */
40
+ private buildPlan;
41
+ /** Apply all pending migrations. With `dryRun`, report the plan only. */
42
+ migrate(opts?: {
43
+ dryRun?: boolean;
44
+ }): Promise<MigrationResult>;
45
+ }
46
+ /** Convenience: build a ledger and run all pending migrations. */
47
+ export declare function createMigrationLedger(client: TypedQueryClient, migrations: readonly Migration[], options?: MigrationRunnerOptions): MigrationLedger;
48
+ //# sourceMappingURL=migrations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/migrations.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAElE;AAQD,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGlB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EACjD,OAAO,GAAE,sBAA2B;IAUhC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAU7B,WAAW,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAKlC,WAAW;IAWzB,oEAAoE;IACpE,OAAO,CAAC,SAAS;IAsBjB,yEAAyE;IACnE,OAAO,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAiBzE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAEjB"}
@@ -0,0 +1,48 @@
1
+ export declare const STORAGE_MODES: readonly ["local", "cloud"];
2
+ export type StorageMode = (typeof STORAGE_MODES)[number];
3
+ export declare const DEPRECATED_STORAGE_MODE_ALIASES: readonly ["remote", "hybrid", "self_hosted"];
4
+ export type Env = Record<string, string | undefined>;
5
+ export interface StorageModeNormalization {
6
+ mode: StorageMode;
7
+ /** The deprecated alias that was normalized to `cloud`, if any. */
8
+ deprecatedAlias: string | null;
9
+ }
10
+ /**
11
+ * Normalize a raw storage-mode string to the `local | cloud` runtime enum.
12
+ * Accepts deprecated aliases (`remote`, `hybrid`, `self_hosted`) and maps them
13
+ * to `cloud`. Throws on any other value.
14
+ */
15
+ export declare function normalizeStorageMode(value: string): StorageModeNormalization;
16
+ /** Upper-snake env token for an app name, e.g. `todos` -> `TODOS`. */
17
+ export declare function envToken(name: string): string;
18
+ export interface StorageEnvKeys {
19
+ /** `HASNA_<NAME>_STORAGE_MODE` then the optional `<NAME>_STORAGE_MODE` alias. */
20
+ modeKeys: string[];
21
+ /** `HASNA_<NAME>_DATABASE_URL` then the optional `<NAME>_DATABASE_URL` alias. */
22
+ databaseUrlKeys: string[];
23
+ }
24
+ /** Resolve the canonical env-key spec for an app's storage config. */
25
+ export declare function storageEnvKeys(name: string): StorageEnvKeys;
26
+ export interface StorageModeResolution {
27
+ mode: StorageMode;
28
+ /** Env key the mode came from, or `"default"`. */
29
+ source: string;
30
+ deprecatedAlias: string | null;
31
+ databaseUrlPresent: boolean;
32
+ /** Env key the database URL came from, or `null`. */
33
+ databaseUrlSource: string | null;
34
+ warning: string | null;
35
+ }
36
+ /**
37
+ * Resolve an app's storage mode from the environment per the contract env spec.
38
+ * Precedence: `HASNA_<NAME>_STORAGE_MODE`, then `<NAME>_STORAGE_MODE`, else
39
+ * `local`. Never reads secret values — only detects DATABASE_URL presence.
40
+ */
41
+ export declare function resolveStorageMode(name: string, env?: Env): StorageModeResolution;
42
+ /**
43
+ * Resolve the database URL value for an app, honoring the canonical then alias
44
+ * env keys. Returns `null` when unset. The caller is responsible for never
45
+ * logging the returned value.
46
+ */
47
+ export declare function resolveDatabaseUrl(name: string, env?: Env): string | null;
48
+ //# sourceMappingURL=mode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/mode.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,aAAa,6BAA8B,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,+BAA+B,8CAIlC,CAAC;AAEX,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,mEAAmE;IACnE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAQ5E;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iFAAiF;IACjF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAM3D;AAUD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,qBAAqB,CAwC9F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,GAAiB,GAAG,MAAM,GAAG,IAAI,CAItF"}
@@ -0,0 +1,34 @@
1
+ import type { Pool } from "pg";
2
+ import { type TlsResolveOptions } from "./tls.js";
3
+ import { type PoolQueryClient } from "./query.js";
4
+ export interface CreatePgPoolOptions extends TlsResolveOptions {
5
+ connectionString: string;
6
+ /** Max clients in the pool. Defaults to pg's default (10). */
7
+ max?: number;
8
+ /** Idle client timeout (ms). */
9
+ idleTimeoutMillis?: number;
10
+ /** Connection acquisition timeout (ms). */
11
+ connectionTimeoutMillis?: number;
12
+ /** Application name reported to Postgres (shows in pg_stat_activity). */
13
+ applicationName?: string;
14
+ }
15
+ /** Build a `pg.Pool` with fleet-standard TLS handling. */
16
+ export declare function createPgPool(options: CreatePgPoolOptions): Pool;
17
+ export interface CreateCloudPoolFromEnvOptions extends TlsResolveOptions {
18
+ max?: number;
19
+ idleTimeoutMillis?: number;
20
+ connectionTimeoutMillis?: number;
21
+ applicationName?: string;
22
+ }
23
+ export interface CloudPoolFromEnv {
24
+ client: PoolQueryClient;
25
+ connectionSource: string;
26
+ }
27
+ /**
28
+ * Resolve mode + database URL from the environment and build a cloud pool.
29
+ *
30
+ * Throws when the resolved mode is not `cloud` (PURE REMOTE has no Postgres in
31
+ * `local` mode) or when the database URL is missing. Never logs the URL.
32
+ */
33
+ export declare function createCloudPoolFromEnv(appName: string, options?: CreateCloudPoolFromEnvOptions): CloudPoolFromEnv;
34
+ //# sourceMappingURL=pool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/pool.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAE3C,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,gBAAgB,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAe/D;AAED,MAAM,WAAW,6BAA8B,SAAQ,iBAAiB;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CAgClB"}
@@ -0,0 +1,36 @@
1
+ import type { Pool, QueryResultRow } from "pg";
2
+ export interface QueryResult<T extends QueryResultRow> {
3
+ rows: T[];
4
+ rowCount: number;
5
+ }
6
+ /**
7
+ * Minimal executor contract. `pg.Pool` and `pg.PoolClient` both satisfy the
8
+ * `query` method; the wrapper builds the rest on top so tests can substitute a
9
+ * lightweight shim without pulling in a live Postgres.
10
+ */
11
+ export interface PgExecutor {
12
+ query<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<{
13
+ rows: T[];
14
+ rowCount: number | null;
15
+ }>;
16
+ }
17
+ export interface TypedQueryClient {
18
+ query<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<QueryResult<T>>;
19
+ many<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T[]>;
20
+ /** First row or `null`. Restored here after open-knowledge dropped it. */
21
+ get<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T | null>;
22
+ /** Exactly one row; throws if zero or more than one row is returned. */
23
+ one<T extends QueryResultRow>(sql: string, params?: readonly unknown[]): Promise<T>;
24
+ execute(sql: string, params?: readonly unknown[]): Promise<void>;
25
+ }
26
+ /** Wrap any `PgExecutor` (a Pool, a PoolClient, or a test shim) with the typed vocabulary. */
27
+ export declare function wrapExecutor(executor: PgExecutor): TypedQueryClient;
28
+ export interface PoolQueryClient extends TypedQueryClient {
29
+ readonly pool: Pool;
30
+ /** Run a callback inside a `BEGIN`/`COMMIT` transaction on a dedicated client. */
31
+ transaction<T>(fn: (client: TypedQueryClient) => Promise<T>): Promise<T>;
32
+ close(): Promise<void>;
33
+ }
34
+ /** Build a `PoolQueryClient` around a live `pg.Pool`. */
35
+ export declare function createQueryClient(pool: Pool): PoolQueryClient;
36
+ //# sourceMappingURL=query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/query.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,IAAI,EAAc,cAAc,EAAE,MAAM,IAAI,CAAC;AAE3D,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,cAAc;IACnD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,CAAC,SAAS,cAAc,EAC5B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvF,0EAA0E;IAC1E,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3F,wEAAwE;IACxE,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,GAAG,gBAAgB,CAyBnE;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,kFAAkF;IAClF,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CA2B7D"}
@@ -0,0 +1,26 @@
1
+ /** The `ssl` field shape accepted by `pg.Pool` / `pg.Client`. */
2
+ export type PgSslConfig = boolean | {
3
+ rejectUnauthorized: boolean;
4
+ ca?: string;
5
+ };
6
+ export interface TlsResolveOptions {
7
+ /** Inline CA bundle (PEM). Wins over every other CA source. */
8
+ ca?: string;
9
+ /** Path to a CA bundle PEM file, e.g. the Amazon RDS global bundle. */
10
+ caCertPath?: string;
11
+ /** Environment used to discover PGSSLROOTCERT / NODE_EXTRA_CA_CERTS. */
12
+ env?: Record<string, string | undefined>;
13
+ }
14
+ export type SslMode = "disable" | "prefer" | "require" | "verify-ca" | "verify-full";
15
+ /**
16
+ * Extract the effective `sslmode` from a Postgres connection string. Honors the
17
+ * `sslmode` query param and the legacy `ssl=true` boolean. Returns `disable`
18
+ * when TLS is not requested.
19
+ */
20
+ export declare function sslModeFromConnectionString(connectionString: string): SslMode;
21
+ /**
22
+ * Resolve the `pg` ssl config for a connection string. See the module header
23
+ * for the full mode table. Returns `undefined` when TLS should be off.
24
+ */
25
+ export declare function resolveTlsConfig(connectionString: string, options?: TlsResolveOptions): PgSslConfig | undefined;
26
+ //# sourceMappingURL=tls.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tls.d.ts","sourceRoot":"","sources":["../../../src/generated/storage-kit/tls.ts"],"names":[],"mappings":"AAkCA,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG;IAAE,kBAAkB,EAAE,OAAO,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAwB7E;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,iBAAsB,GAC9B,WAAW,GAAG,SAAS,CA2BzB"}