@rebasepro/server-postgres 0.0.1-canary.fc811d7 → 0.9.1-canary.09aaf62

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 (57) hide show
  1. package/dist/PostgresBackendDriver.d.ts +25 -2
  2. package/dist/PostgresBootstrapper.d.ts +10 -0
  3. package/dist/auth/services.d.ts +16 -0
  4. package/dist/collections/buildRegistry.d.ts +27 -0
  5. package/dist/connection.d.ts +21 -0
  6. package/dist/data-transformer.d.ts +9 -2
  7. package/dist/index.es.js +2005 -2583
  8. package/dist/index.es.js.map +1 -1
  9. package/dist/module-dir.d.ts +1 -0
  10. package/dist/schema/doctor.d.ts +1 -1
  11. package/dist/security/policy-drift.d.ts +46 -5
  12. package/dist/security/rls-enforcement.d.ts +27 -2
  13. package/dist/services/FetchService.d.ts +4 -24
  14. package/dist/services/PersistService.d.ts +27 -1
  15. package/dist/services/RelationService.d.ts +34 -1
  16. package/dist/services/collection-helpers.d.ts +79 -14
  17. package/dist/services/dataService.d.ts +3 -1
  18. package/dist/services/index.d.ts +1 -1
  19. package/dist/services/realtimeService.d.ts +7 -0
  20. package/dist/services/row-pipeline.d.ts +63 -0
  21. package/package.json +15 -17
  22. package/src/PostgresBackendDriver.ts +127 -13
  23. package/src/PostgresBootstrapper.ts +68 -26
  24. package/src/auth/ensure-tables.ts +73 -11
  25. package/src/auth/services.ts +49 -19
  26. package/src/cli-helpers.ts +2 -20
  27. package/src/cli.ts +60 -0
  28. package/src/collections/buildRegistry.ts +59 -0
  29. package/src/connection.ts +61 -1
  30. package/src/data-transformer.ts +11 -9
  31. package/src/databasePoolManager.ts +2 -0
  32. package/src/module-dir.ts +7 -0
  33. package/src/schema/doctor-cli.ts +5 -1
  34. package/src/schema/doctor.ts +45 -20
  35. package/src/schema/generate-drizzle-schema-logic.ts +24 -29
  36. package/src/schema/generate-postgres-ddl-logic.ts +76 -28
  37. package/src/schema/introspect-db.ts +19 -2
  38. package/src/security/anonymous-grants.test.ts +71 -0
  39. package/src/security/policy-drift.test.ts +153 -14
  40. package/src/security/policy-drift.ts +128 -10
  41. package/src/security/rls-enforcement.ts +64 -3
  42. package/src/services/BranchService.ts +42 -10
  43. package/src/services/FetchService.ts +65 -270
  44. package/src/services/PersistService.ts +130 -14
  45. package/src/services/RelationService.ts +153 -94
  46. package/src/services/collection-helpers.ts +164 -47
  47. package/src/services/dataService.ts +3 -2
  48. package/src/services/index.ts +1 -0
  49. package/src/services/realtimeService.ts +40 -19
  50. package/src/services/row-pipeline.ts +239 -0
  51. package/src/utils/drizzle-conditions.ts +13 -0
  52. package/src/websocket.ts +4 -1
  53. package/dist/chunk-DSJWtz9O.js +0 -40
  54. package/dist/schema/auth-default-policies.d.ts +0 -10
  55. package/dist/src-Eh-CZosp.js +0 -595
  56. package/dist/src-Eh-CZosp.js.map +0 -1
  57. package/src/schema/auth-default-policies.ts +0 -125
@@ -0,0 +1 @@
1
+ export declare const moduleDir: string;
@@ -2,7 +2,7 @@ import { CollectionConfig, Property } from "@rebasepro/types";
2
2
  export type IssueSeverity = "error" | "warning" | "info";
3
3
  export interface DoctorIssue {
4
4
  severity: IssueSeverity;
5
- category: "missing_table" | "missing_column" | "type_mismatch" | "missing_constraint" | "schema_stale" | "missing_enum" | "enum_value_mismatch" | "missing_foreign_key" | "sdk_stale";
5
+ category: "missing_table" | "missing_column" | "type_mismatch" | "missing_constraint" | "schema_stale" | "missing_enum" | "enum_value_mismatch" | "missing_foreign_key" | "sdk_stale" | "sdk_not_generated";
6
6
  table?: string;
7
7
  column?: string;
8
8
  expected?: string;
@@ -22,6 +22,10 @@ export interface PolicyRef {
22
22
  roles: string[];
23
23
  /** SELECT / INSERT / UPDATE / DELETE / ALL. */
24
24
  command: string;
25
+ /** Whether a USING clause is present at all (not what it says). */
26
+ hasUsing: boolean;
27
+ /** Whether a WITH CHECK clause is present at all (not what it says). */
28
+ hasWithCheck: boolean;
25
29
  }
26
30
  export interface PolicyDrift {
27
31
  /** Described by the collections, absent from the database. */
@@ -45,13 +49,50 @@ export declare function parseExpectedPolicies(ddl: string): PolicyRef[];
45
49
  /**
46
50
  * Diff expected against live.
47
51
  *
48
- * Compares names, roles and command only — all exact values. Policy
49
- * *expressions* are deliberately not compared: Postgres rewrites `qual`/
50
- * `with_check` when storing them (parenthesising, casting, schema-qualifying),
51
- * so text comparison reports drift that does not exist, and a check that cries
52
- * wolf gets ignored. Roles alone catch the failure this exists for.
52
+ * Compares names, roles, command, and whether each clause exists — all exact
53
+ * values. Policy expression *text* is deliberately not compared: Postgres
54
+ * rewrites `qual`/`with_check` when storing them (parenthesising, casting,
55
+ * schema-qualifying), so text comparison reports drift that does not exist, and
56
+ * a check that cries wolf gets ignored.
57
+ *
58
+ * Presence is not text, though. A NULL `qual` is not a rewrite of an
59
+ * expression, it is the absence of one, and absence has no false-positive risk:
60
+ * either the generator emitted a clause or it did not. That distinction is worth
61
+ * the extra comparison — a production database was found with a SELECT policy
62
+ * whose `qual` was NULL, matching on every field this checked and denying 100%
63
+ * of reads. The same blindness would hide a policy that fails open.
53
64
  */
54
65
  export declare function checkPolicyDrift(client: Queryable, collections: CollectionConfig[]): Promise<PolicyDrift>;
66
+ /**
67
+ * Does this name look like one the generator produced for this table?
68
+ *
69
+ * Unnamed rules compile to `<table>_<op>_<sha1[0:7]>` (plus `_<idx>` when one
70
+ * rule spans several operations), and the hash covers the rule's semantics — so
71
+ * *editing* a rule renames its policy. The policy under the old name is left
72
+ * behind by `db push`, which only DROPs the names it is about to CREATE, and
73
+ * Postgres ORs PERMISSIVE policies together: a superseded `USING (true)` keeps
74
+ * granting everything no matter how tight its replacement is.
75
+ *
76
+ * Matching the shape is what makes dropping them safe. A hand-written policy
77
+ * would have to collide with a 7-hex digest to be mistaken for generated one;
78
+ * a policy named anything else is left alone and merely reported, because a
79
+ * custom name is indistinguishable from one someone wrote in SQL on purpose.
80
+ */
81
+ export declare function isGeneratedPolicyName(name: string, table: string): boolean;
82
+ export interface OrphanCleanup {
83
+ /** Superseded generated policies that were dropped. */
84
+ dropped: PolicyRef[];
85
+ /** Orphans left in place because their names are not generator-shaped. */
86
+ kept: PolicyRef[];
87
+ }
88
+ /**
89
+ * Drop the policies an earlier push superseded but never removed.
90
+ *
91
+ * Only touches tables the collections describe — a table with no expected
92
+ * policy is not ours to reconcile, and scanning by schema alone would sweep up
93
+ * policies belonging to something else sharing the database.
94
+ */
95
+ export declare function dropOrphanedPolicies(client: Queryable, drift: PolicyDrift, collections: CollectionConfig[]): Promise<OrphanCleanup>;
55
96
  export declare const hasDrift: (d: PolicyDrift) => boolean;
56
97
  /** Human-readable report; empty string when the database matches the config. */
57
98
  export declare function formatPolicyDrift(drift: PolicyDrift): string;
@@ -1,4 +1,5 @@
1
1
  import { SQL } from "drizzle-orm";
2
+ import { SecurityRule } from "@rebasepro/types";
2
3
  /**
3
4
  * Unified RLS enforcement — the "user context vs server context" model.
4
5
  *
@@ -94,10 +95,34 @@ export declare function ensureAppRole(run: RawSqlRunner, schemas: string[]): Pro
94
95
  * treat `auth.uid() IS NULL` as the trusted server context, and `auth.uid()`
95
96
  * is `NULLIF(current_setting('app.user_id'), '')` — so an EMPTY user id would
96
97
  * be read as NULL and silently escalate a user request to server privileges.
97
- * Coerce empty/blank ids to a sentinel here, at the single chokepoint, rather
98
- * than trusting every caller (e.g. realtime subscription auth) to do it.
98
+ * Coerce empty/blank ids to `ANONYMOUS_USER_ID` here, at the single chokepoint,
99
+ * rather than trusting every caller (e.g. realtime subscription auth) to do it.
100
+ * That sentinel is exported from `@rebasepro/types` because it leaks into rule
101
+ * semantics: it is why `auth.uid() IS NOT NULL` is true for anonymous requests.
99
102
  */
100
103
  export declare function applyAuthContext(tx: SqlTx, auth: AuthContext, userRole?: string): Promise<void>;
104
+ /**
105
+ * Warn about rules that read as "signed-in users only" but admit anonymous
106
+ * callers — `auth.uid() IS NOT NULL`, or a comparison against another
107
+ * platform's magic user id such as `'anon'`.
108
+ *
109
+ * The sibling of {@link validatePolicyPgRoles}, for the more dangerous spelling
110
+ * of the same habit. A foreign `pgRoles` value makes a policy unreachable and
111
+ * the table reads empty — loud, and that guard throws. These do the opposite:
112
+ * the rule compiles to a grant, and nothing looks wrong until the data is
113
+ * already public.
114
+ *
115
+ * Warns rather than throws. Unlike an unreachable `pgRoles`, these rules are
116
+ * serving traffic today: refusing to boot would take an app offline to report a
117
+ * problem it already has, and on the read path it would take it offline
118
+ * *because* its data was exposed. Rewriting the author's SQL is not an option
119
+ * either — this is the escape hatch whose whole promise is that it means what it
120
+ * says. So: say so, loudly, and leave the rule alone.
121
+ */
122
+ export declare function warnOnAnonymousGrants(collections: {
123
+ slug?: string;
124
+ securityRules?: readonly SecurityRule[];
125
+ }[]): void;
101
126
  /**
102
127
  * Reject `pgRoles` that this server can never satisfy.
103
128
  *
@@ -40,44 +40,22 @@ export declare class FetchService {
40
40
  * the target relation so actual row data is returned.
41
41
  */
42
42
  private buildWithConfig;
43
- /**
44
- * Detect if a many-to-many relation uses a junction table in the Drizzle schema.
45
- */
46
- private isJunctionRelation;
47
43
  /**
48
44
  * Get the Drizzle relation name on the junction table that points to the actual target row.
49
45
  * For example, for posts_tags junction, this returns "tag_id" (the relation pointing to tags).
50
46
  */
51
47
  private getJunctionTargetRelationName;
52
- /**
53
- * Convert a db.query result row (with nested relation objects) to a flat row.
54
- * Handles:
55
- * - Placing `id` at the top level as a string
56
- * - Type normalization (dates, numbers, NaN) via normalizeDbValues
57
- * - Converting nested relation objects to { id, path, __type: "relation" } for CMS
58
- * - Flattening junction-table many-to-many results
59
- */
60
- private drizzleResultToRow;
61
48
  /**
62
49
  * Post-fetch joinPath relations for a single flat row.
63
50
  * joinPath relations cannot be expressed via Drizzle's `with` config,
64
51
  * so they must be loaded separately after the primary query.
65
52
  */
66
53
  private resolveJoinPathRelations;
67
- /**
68
- * Post-fetch joinPath relations for a batch of flat rows.
69
- * Uses batch fetching to avoid N+1 queries for list views.
70
- */
71
- private resolveJoinPathRelationsBatch;
72
54
  /**
73
55
  * Resolves joinPath relations for raw REST rows and directly injects them.
74
56
  * Uses RelationService to query the database and maps results back to the flattened objects.
75
57
  */
76
58
  private resolveJoinPathRelationsBatchRest;
77
- /**
78
- * Convert a db.query result row to a flat REST-style object with populated relations.
79
- */
80
- private drizzleResultToRestRow;
81
59
  /**
82
60
  * Build db.query-compatible options from standard fetch options.
83
61
  * Handles filter, search, orderBy, limit, and cursor-based pagination.
@@ -108,8 +86,10 @@ export declare class FetchService {
108
86
  }): Promise<Record<string, unknown>[]>;
109
87
  /**
110
88
  * Fallback path used when db.query is unavailable.
111
- * The primary path uses drizzleResultToRow which handles relation
112
- * mapping without N+1 queries.
89
+ *
90
+ * The primary path runs the results through `toCmsRow`, which maps
91
+ * relations from what drizzle already nested — no query per row. This one
92
+ * has no nesting to read, so it resolves relations itself, in batches.
113
93
  *
114
94
  * Process raw database results into flat rows with relations.
115
95
  */
@@ -12,6 +12,24 @@ export declare class PersistService {
12
12
  private relationService;
13
13
  private fetchService;
14
14
  constructor(db: DrizzleClient, registry: PostgresCollectionRegistry);
15
+ /**
16
+ * Explain a write that matched no rows.
17
+ *
18
+ * Row-level security filters UPDATE and DELETE through the policy's USING
19
+ * clause instead of raising: a denied write is reported by Postgres exactly
20
+ * like a successful one that happened to match nothing. Left unchecked, a
21
+ * caller cannot tell "denied" from "done" — the write returns 200/204 and
22
+ * the row is untouched.
23
+ *
24
+ * Re-reading the target over the *same* RLS-scoped handle separates the two
25
+ * cases. A visible row means the policy rejected the write (403); an
26
+ * invisible one means there is nothing there to write for this caller (404,
27
+ * matching what a GET would say). The re-read is bound by the caller's own
28
+ * policies, so it discloses nothing a plain read wouldn't.
29
+ *
30
+ * Only reached when zero rows matched, so the happy path pays nothing.
31
+ */
32
+ private explainZeroRowWrite;
15
33
  /**
16
34
  * Delete an row by ID
17
35
  */
@@ -22,8 +40,16 @@ export declare class PersistService {
22
40
  deleteAll(collectionPath: string, _databaseId?: string): Promise<void>;
23
41
  /**
24
42
  * Save an row (create or update)
43
+ *
44
+ * With `options.upsert`, the row is written with INSERT ... ON CONFLICT DO
45
+ * UPDATE against the primary key rather than a plain UPDATE. That is one
46
+ * statement, so it cannot lose a race the way a read-then-write can, and it
47
+ * does not care whether the row already exists — which is what a re-runnable
48
+ * import needs.
25
49
  */
26
- save<M extends Record<string, unknown>>(collectionPath: string, values: Partial<M>, id?: string | number, databaseId?: string): Promise<Record<string, unknown>>;
50
+ save<M extends Record<string, unknown>>(collectionPath: string, values: Partial<M>, id?: string | number, databaseId?: string, options?: {
51
+ upsert?: boolean;
52
+ }): Promise<Record<string, unknown>>;
27
53
  /**
28
54
  * Get the RelationService instance for external use
29
55
  */
@@ -20,6 +20,40 @@ export declare class RelationService {
20
20
  private db;
21
21
  private registry;
22
22
  constructor(db: DrizzleClient, registry: PostgresCollectionRegistry);
23
+ /**
24
+ * One target row, as the {@link RelatedRow} everything here returns.
25
+ *
26
+ * Eight sites built this by hand, which is how the address came to be the
27
+ * target's first key column in all eight — one edit, eight places to miss.
28
+ *
29
+ * `resolveNested` is the one thing they did not agree on, and the
30
+ * disagreement was invisible: the single-parent fetches pass `db` and
31
+ * `registry` to `parseDataFromServer`, so the target's *own* relations get
32
+ * resolved too, while the batch paths deliberately do not — a query per
33
+ * target row is the N+1 the batching exists to avoid. Naming the parameter
34
+ * makes that a decision rather than a difference between two call sites
35
+ * nobody was comparing.
36
+ */
37
+ private toRelatedRow;
38
+ /**
39
+ * A WHERE matching any of `parentIds`, by the whole key.
40
+ *
41
+ * A single key is an `IN (…)`. A composite one cannot be: matching
42
+ * `tenant_id IN (1, 1)` collects every row of tenant 1, so two parents that
43
+ * share their first column each receive the other's relations. It becomes
44
+ * an OR of ANDs — one exact address per parent — which Postgres indexes the
45
+ * same way it would a multi-column key lookup.
46
+ */
47
+ private parentKeyCondition;
48
+ /**
49
+ * Reject a relation that cannot express a composite-keyed parent.
50
+ *
51
+ * `localKey` and `foreignKeyOnTarget` are single column names: one column
52
+ * cannot reference a two-column key, so such a relation has no correct
53
+ * reading. Left alone it would silently match on the first key column and
54
+ * hand a tenant's rows to its neighbour — say so instead.
55
+ */
56
+ private assertSingleKeyAddressable;
23
57
  /**
24
58
  * Fetch rows related to a parent row through a specific relation
25
59
  */
@@ -72,7 +106,6 @@ export declare class RelationService {
72
106
  relationKey: string;
73
107
  relation: Relation;
74
108
  newValue: unknown;
75
- currentId?: string | number;
76
109
  }>): Promise<void>;
77
110
  /**
78
111
  * Handle inverse relations with joinPath
@@ -1,6 +1,9 @@
1
1
  import { PgTable, AnyPgColumn } from "drizzle-orm/pg-core";
2
2
  import { CollectionConfig } from "@rebasepro/types";
3
3
  import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
4
+ export { buildCompositeId, parseIdValues, COMPOSITE_ID_SEPARATOR } from "@rebasepro/common";
5
+ export type { PrimaryKeyInfo } from "@rebasepro/common";
6
+ import type { PrimaryKeyInfo } from "@rebasepro/common";
4
7
  /**
5
8
  * Shared helper functions for row operations.
6
9
  * These are used by FetchService, PersistService, and RelationService.
@@ -21,18 +24,80 @@ export interface DrizzleColumnMeta {
21
24
  export declare function getColumnMeta(col: AnyPgColumn): DrizzleColumnMeta;
22
25
  export declare function getCollectionByPath(collectionPath: string, registry: PostgresCollectionRegistry): CollectionConfig;
23
26
  export declare function getTableForCollection(collection: CollectionConfig, registry: PostgresCollectionRegistry): PgTable<any>;
24
- export declare function getPrimaryKeys(collection: CollectionConfig, registry: PostgresCollectionRegistry): {
25
- fieldName: string;
26
- type: "string" | "number";
27
- isUUID?: boolean;
27
+ /**
28
+ * The key columns a collection's rows are addressed by.
29
+ *
30
+ * Three tiers, in order: properties marked `isId`, the primary keys of the
31
+ * drizzle schema, and finally a column literally named `id`. Only the first is
32
+ * visible to the browser, which is why a key known only to drizzle is reported
33
+ * at boot — see {@link warnOnKeysTheAdminCannotResolve}.
34
+ *
35
+ * Returns `[]` when nothing resolves, rather than throwing. It used to open by
36
+ * resolving the table, which throws when there is none — so the `isId` tier,
37
+ * which needs no table at all, was unreachable for exactly the collections
38
+ * most likely to have no table registered. Every caller that wanted "no keys"
39
+ * to mean "no keys" had to spell that out in a try/catch.
40
+ *
41
+ * Callers that cannot proceed without a key must say so themselves, naming the
42
+ * collection: an empty array here means "this collection has no address", which
43
+ * is a different answer in a notification (broadcast a wildcard) than in a save
44
+ * (fail).
45
+ */
46
+ export declare function getPrimaryKeys(collection: CollectionConfig, registry: PostgresCollectionRegistry): PrimaryKeyInfo[];
47
+ /**
48
+ * The key columns, for callers that cannot do their job without one.
49
+ *
50
+ * {@link getPrimaryKeys} answers "what keys, if any" and returns `[]` for a
51
+ * collection with no address. Most of this driver, though, is building a WHERE
52
+ * clause and has no meaning without a key — for those, an empty array is not an
53
+ * answer, and indexing `[0]` into it produces `Cannot read properties of
54
+ * undefined` three frames from where the real problem is. This says what is
55
+ * wrong and which collection it is wrong about.
56
+ */
57
+ export declare function requirePrimaryKeys(collection: CollectionConfig, registry: PostgresCollectionRegistry): PrimaryKeyInfo[];
58
+ /**
59
+ * Collections whose key the *browser* cannot resolve, and what it will do
60
+ * instead.
61
+ *
62
+ * The two sides resolve keys from different evidence. This driver reads, in
63
+ * order: properties marked `isId`, the primary keys of the Drizzle schema, then
64
+ * a column literally named `id`. The admin shares the `CollectionConfig` — it
65
+ * compiles the same collection files into its bundle — but never the Drizzle
66
+ * schema, so the middle tier is invisible to it.
67
+ *
68
+ * Nothing can normalize this at runtime: the server does not serve the admin
69
+ * its collections, so a key resolved here cannot be handed over there. The
70
+ * config files are the only thing both sides read, so the fix is an edit to
71
+ * them, and the most this can do is say exactly which edit.
72
+ *
73
+ * Two shapes, and the second is the dangerous one:
74
+ *
75
+ * - No `isId`, no `id` property → the admin resolves no address, warns in the
76
+ * console, and rows cannot be opened or linked.
77
+ * - No `isId`, but an `id` property that is *not* the key → the admin addresses
78
+ * rows by `id` while this driver reads the address as the real key. Nothing
79
+ * errors: the addresses look right and route wrong.
80
+ */
81
+ export declare function findUnresolvableKeyCollections(collections: CollectionConfig[], registry: PostgresCollectionRegistry): {
82
+ collection: CollectionConfig;
83
+ keys: PrimaryKeyInfo[];
84
+ shadowedByIdProperty: boolean;
28
85
  }[];
29
- export declare function parseIdValues(idValue: string | number, primaryKeys: {
30
- fieldName: string;
31
- type: "string" | "number";
32
- isUUID?: boolean;
33
- }[]): Record<string, string | number>;
34
- export declare function buildCompositeId(values: Record<string, unknown>, primaryKeys: {
35
- fieldName: string;
36
- type: "string" | "number";
37
- isUUID?: boolean;
38
- }[]): string;
86
+ /**
87
+ * Report the collections from {@link findUnresolvableKeyCollections} at boot,
88
+ * with the edit that fixes each one.
89
+ *
90
+ * Grouped by failure, not by collection: the shadowed case is a routing bug and
91
+ * the silent case is a missing feature, and they deserve different urgency.
92
+ */
93
+ export declare function warnOnKeysTheAdminCannotResolve(collections: CollectionConfig[], registry: PostgresCollectionRegistry): void;
94
+ /**
95
+ * The address of a row: derived from the collection's primary keys, because a
96
+ * row does not carry one — it is exactly its columns.
97
+ *
98
+ * Falls back to a literal `id` column, for a row that reached us from somewhere
99
+ * other than this driver. Returns `""` when there is no key and no `id` —
100
+ * callers decide what that means, since "unaddressable" is a different answer
101
+ * in a notification (broadcast a wildcard) than in a save (fail).
102
+ */
103
+ export declare function deriveRowAddress(row: Record<string, unknown>, collection: CollectionConfig, registry: PostgresCollectionRegistry): string;
@@ -82,7 +82,9 @@ export declare class DataService implements DataRepository {
82
82
  /**
83
83
  * Save an row (create or update)
84
84
  */
85
- save<M extends Record<string, unknown>>(collectionPath: string, values: Partial<M>, id?: string | number, databaseId?: string): Promise<Record<string, unknown>>;
85
+ save<M extends Record<string, unknown>>(collectionPath: string, values: Partial<M>, id?: string | number, databaseId?: string, options?: {
86
+ upsert?: boolean;
87
+ }): Promise<Record<string, unknown>>;
86
88
  /**
87
89
  * Delete an row by ID
88
90
  */
@@ -1,4 +1,4 @@
1
1
  export { FetchService } from "./FetchService";
2
2
  export { PersistService } from "./PersistService";
3
3
  export { RelationService } from "./RelationService";
4
- export { getCollectionByPath, getTableForCollection, getPrimaryKeys, parseIdValues, buildCompositeId } from "./collection-helpers";
4
+ export { getCollectionByPath, getTableForCollection, getPrimaryKeys, deriveRowAddress, parseIdValues, buildCompositeId } from "./collection-helpers";
@@ -177,8 +177,15 @@ export declare class RealtimeService extends EventEmitter implements RealtimePro
177
177
  /**
178
178
  * Send a lightweight row-level patch to a collection subscriber.
179
179
  * The client can merge this into its cached data for instant feedback.
180
+ *
181
+ * The key columns ride along: the patch names a row by address, and the
182
+ * client has to find that row among the ones it cached — which carry
183
+ * columns and no address. The SDK holds no collection config to derive one
184
+ * from, so this is the only place the mapping can come from.
180
185
  */
181
186
  private sendCollectionPatch;
187
+ /** The key columns of the collection at `path`, if they can be resolved. */
188
+ private primaryKeysForPath;
182
189
  private sendError;
183
190
  private sendMessage;
184
191
  /**
@@ -0,0 +1,63 @@
1
+ import { CollectionConfig, Relation } from "@rebasepro/types";
2
+ import { PostgresCollectionRegistry } from "../collections/PostgresCollectionRegistry";
3
+ /**
4
+ * Turning a drizzle result into a row we serve.
5
+ *
6
+ * There are two shapes, and they are the same walk. Both take a row whose
7
+ * relation fields hold nested objects, both unwrap junction rows to reach the
8
+ * target behind them, and both leave every other column alone. They differ only
9
+ * in what they put where the relation was:
10
+ *
11
+ * - `"ref"` — a `{ id, path, __type: "relation" }` reference carrying the
12
+ * target's values. This is what the admin renders.
13
+ * - `"inline"` — the target's own columns, flat. This is what REST serves.
14
+ *
15
+ * They used to be two functions that happened to agree, and the agreement was
16
+ * not enforced by anything: the row-identity bug had to be fixed five times
17
+ * across differently-shaped copies of this walk, and one of the copies was
18
+ * dead code nobody had noticed. Whatever the next cross-cutting change is, it
19
+ * is one edit here.
20
+ */
21
+ export type RelationStyle = "ref" | "inline";
22
+ /**
23
+ * Whether a many-relation reaches its target through a junction table.
24
+ *
25
+ * Also used to build the drizzle `with` config, which is why it is exported:
26
+ * the query has to nest one level deeper for a junction, and the row walk has
27
+ * to unwrap that same level back out.
28
+ */
29
+ export declare function isJunctionRelation(relation: Relation): boolean;
30
+ /**
31
+ * The address a relation ref points at.
32
+ *
33
+ * The whole key, not its first column: a composite-keyed target addressed by
34
+ * `tenant_id` alone points at every row that shares it. A target whose key
35
+ * cannot be resolved at all used to throw here — reading `[0]` of an empty
36
+ * array — taking down the parent's fetch over a relation it may not even have
37
+ * asked for. The first column is a guess, but a ref that resolves to nothing
38
+ * beats no rows at all.
39
+ */
40
+ export declare function relationTargetAddress(targetRow: Record<string, unknown>, targetCollection: CollectionConfig, registry: PostgresCollectionRegistry): string;
41
+ /**
42
+ * The row the admin renders: every column, with relations as references.
43
+ *
44
+ * Values are normalized (dates, numbers, NaN) because the admin's view-model
45
+ * expects real types. The row's own address is *not* among the columns — it is
46
+ * derived by the consumer from the collection's primary keys.
47
+ */
48
+ export declare function toCmsRow(row: Record<string, unknown>, collection: CollectionConfig, registry: PostgresCollectionRegistry): Record<string, unknown>;
49
+ /**
50
+ * The row REST serves: every column under its own name, with the value Postgres
51
+ * returned, and relations inlined as the target's columns.
52
+ *
53
+ * Values are the ones the database returned, except where that contradicts the
54
+ * declared type: a `number` property is served as a number (see
55
+ * {@link coerceDeclaredNumber}). Dates stay as the database returned them —
56
+ * JSON has its own opinions about dates that the admin's view-model does not
57
+ * share.
58
+ *
59
+ * Keyed by the row rather than by the relation list — a REST fetch only loads
60
+ * the relations `include` asked for, so the row is the authority on which are
61
+ * actually there.
62
+ */
63
+ export declare function toRestRow(row: Record<string, unknown>, collection: CollectionConfig, registry: PostgresCollectionRegistry): Record<string, unknown>;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@rebasepro/server-postgres",
3
3
  "type": "module",
4
- "version": "0.0.1-canary.fc811d7",
4
+ "version": "0.9.1-canary.09aaf62",
5
5
  "description": "PostgreSQL data source backend implementation for Rebase with Drizzle ORM",
6
6
  "funding": {
7
7
  "url": "https://github.com/sponsors/rebaseco"
@@ -13,7 +13,7 @@
13
13
  "url": "https://github.com/rebasepro/rebase.git",
14
14
  "directory": "packages/server-postgres"
15
15
  },
16
- "main": "./dist/index.umd.js",
16
+ "main": "./dist/index.es.js",
17
17
  "module": "./dist/index.es.js",
18
18
  "types": "./dist/index.d.ts",
19
19
  "source": "src/index.ts",
@@ -48,11 +48,8 @@
48
48
  ],
49
49
  "moduleNameMapper": {
50
50
  "^chalk$": "<rootDir>/test/mocks/chalk.cjs",
51
- "^@rebasepro/client$": "<rootDir>/../client/src/index.ts",
52
- "^@rebasepro/common$": "<rootDir>/../common/src/index.ts",
53
- "^@rebasepro/types$": "<rootDir>/../types/src/index.ts",
54
- "^@rebasepro/utils$": "<rootDir>/../utils/src/index.ts",
55
- "^@rebasepro/server$": "<rootDir>/../server/src/index.ts",
51
+ "^\\.{1,2}/module-dir$": "<rootDir>/test/mocks/module-dir.cjs",
52
+ "^@rebasepro/([a-z0-9-]+)$": "<rootDir>/../$1/src/index.ts",
56
53
  "^(\\.{1,2}/.*)\\.js$": "$1"
57
54
  }
58
55
  },
@@ -60,8 +57,7 @@
60
57
  ".": {
61
58
  "types": "./dist/index.d.ts",
62
59
  "development": "./dist/index.es.js",
63
- "import": "./dist/index.es.js",
64
- "require": "./dist/index.umd.js"
60
+ "import": "./dist/index.es.js"
65
61
  },
66
62
  "./package.json": "./package.json"
67
63
  },
@@ -73,21 +69,22 @@
73
69
  "dotenv": "^17.4.2",
74
70
  "drizzle-orm": "^0.45.2",
75
71
  "execa": "^9.6.1",
76
- "hono": "^4.12.25",
77
72
  "pg": "^8.21.0",
78
73
  "ws": "^8.21.0",
79
- "@rebasepro/common": "0.0.1-canary.fc811d7",
80
- "@rebasepro/server": "0.0.1-canary.fc811d7",
81
- "@rebasepro/codegen": "0.0.1-canary.fc811d7",
82
- "@rebasepro/types": "0.0.1-canary.fc811d7",
83
- "@rebasepro/utils": "0.0.1-canary.fc811d7"
74
+ "@rebasepro/codegen": "0.9.1-canary.09aaf62",
75
+ "@rebasepro/server": "0.9.1-canary.09aaf62",
76
+ "@rebasepro/types": "0.9.1-canary.09aaf62",
77
+ "@rebasepro/utils": "0.9.1-canary.09aaf62",
78
+ "@rebasepro/common": "0.9.1-canary.09aaf62"
84
79
  },
85
80
  "devDependencies": {
81
+ "@hono/node-server": "^2.0.9",
86
82
  "@types/jest": "^30.0.0",
87
83
  "@types/node": "^25.9.3",
88
84
  "@types/pg": "^8.20.0",
89
85
  "@types/ws": "^8.18.1",
90
86
  "@vitejs/plugin-react": "^6.0.2",
87
+ "hono": "^4.12.25",
91
88
  "jest": "^30.4.2",
92
89
  "ts-jest": "^29.4.11",
93
90
  "typescript": "^6.0.3",
@@ -104,10 +101,11 @@
104
101
  ],
105
102
  "scripts": {
106
103
  "watch": "vite build --watch",
107
- "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.prod.json",
104
+ "build": "vite build && tsc --emitDeclarationOnly -p tsconfig.prod.json && node ../../scripts/assert-build-output.mjs",
108
105
  "test:lint": "eslint \"src/**\" --quiet",
109
106
  "test": "jest --passWithNoTests",
110
107
  "test:e2e": "vitest run --config vitest.e2e.config.ts",
111
- "clean": "rm -rf dist && find ./src -name '*.js' -type f | xargs rm -f"
108
+ "clean": "rm -rf dist && find ./src -name '*.js' -type f | xargs rm -f",
109
+ "smoke:baas": "tsx scripts/smoke-baas.ts"
112
110
  }
113
111
  }