@pwfabric/cli 1.0.0-rc.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,45 +2,40 @@
2
2
  * The app's own records, in memory (data-protocol §5).
3
3
  *
4
4
  * One collection per entity type declared in `app/definitions/entities.json`,
5
- * seeded on first use from `app/data/` (see `readSeed`). A record is
6
- * `{ …fields, id, entityType, createdAt, updatedAt }`, fields spread at the
7
- * top level like the reference server's.
5
+ * seeded on first use from `app/content/` then `app/data/` (see `readSeed`). A
6
+ * record is `{ …fields, id, entityType, createdAt, updatedAt }`, fields spread
7
+ * at the top level like the reference server's.
8
8
  *
9
- * ACCESS, read off the declarations — a deliberately small version of what a
10
- * hosted session server decides:
9
+ * ACCESS is the app's `auth.json` `access.rules` (definitions, `access`):
11
10
  *
12
- * - `auth.json` `required: true`: every data request needs a session
13
- * (`401 SIGN_IN_REQUIRED`).
14
- * - A collection is OWNER-SCOPED when an `access.rules[]` entry names it and
15
- * is not a public read grant (subject `public`/`anyone`/`visitors`/…, a
16
- * rule that grants reading and does not say "own"), when the entity
17
- * declares an owner field (`owner`, `ownerId`, `userId`, `createdBy`, …),
18
- * or when the entity carries `"scope": "owner"`. An owner-scoped collection
19
- * needs a session, lists only the caller's rows, and answers another
20
- * visitor's row as `404`.
21
- * - Every other collection is shared by the whole app: anyone may read and
22
- * write it.
11
+ * - `required: true`: every data request needs a session (`401`).
12
+ * - A model no rule names is open to every visitor.
13
+ * - A model some rule names is closed: a request passes when a rule whose
14
+ * subject matches the caller (`public`, `member`, or one of the caller's
15
+ * roles) grants its verb. `own` limits the grant to the caller's records.
16
+ * - Refused: `401 SIGN_IN_REQUIRED` without a session, `403 FORBIDDEN` with
17
+ * one; a record outside an `own` grant is `404`.
18
+ *
19
+ * The development user carries every role `access.roles` declares, so the
20
+ * author can try the app as staff; any other e-mail signs in as a plain member.
23
21
  */
24
22
  import { randomUUID } from 'node:crypto';
25
23
  import { HostError } from './http.js';
26
24
  import { readSeed } from './definitions.js';
27
25
  import { aggregate, matches, parseFilter, parseSort, sortRows } from './query.js';
28
- const PUBLIC_SUBJECTS = new Set([
29
- 'public',
30
- 'anyone',
31
- 'anybody',
32
- 'everyone',
33
- 'everybody',
34
- 'all',
35
- 'visitor',
36
- 'visitors',
37
- 'guest',
38
- 'guests',
39
- 'anonymous',
40
- '*',
41
- ]);
42
- const READ_VERB = /\b(read|reads|see|sees|view|views|list|lists|browse|browses)\b/i;
43
- const OWN_WORD = /\b(own|their|his|her|only)\b/i;
26
+ const VERBS = {
27
+ create: ['create'],
28
+ list: ['list'],
29
+ view: ['view'],
30
+ update: ['update'],
31
+ delete: ['delete'],
32
+ count: ['count'],
33
+ read: ['list', 'view'],
34
+ write: ['create', 'update', 'delete'],
35
+ };
36
+ const OPEN = { create: 'all', list: 'all', view: 'all', update: 'all', delete: 'all', count: 'all' };
37
+ const RANK = { none: 0, own: 1, all: 2 };
38
+ /** Fields a record names its owner in; a create fills the first one when blank. */
44
39
  const OWNER_FIELDS = new Set([
45
40
  'owner',
46
41
  'ownerid',
@@ -57,15 +52,43 @@ const norm = (s) => s.toLowerCase().replace(/[\s_-]/g, '');
57
52
  function ownerFieldOf(entity) {
58
53
  return entity.fields.find((f) => OWNER_FIELDS.has(norm(f.name)))?.name;
59
54
  }
60
- export function scopeOf(entity, auth) {
55
+ /** The words of a rule: verbs and `own`; anything else is ignored. */
56
+ export function parseRule(rule) {
57
+ const verbs = new Set();
58
+ const unknown = [];
59
+ let own = false;
60
+ for (const word of rule.toLowerCase().split(/[\s,]+/).filter(Boolean)) {
61
+ if (word === 'own')
62
+ own = true;
63
+ else if (VERBS[word])
64
+ for (const v of VERBS[word])
65
+ verbs.add(v);
66
+ else
67
+ unknown.push(word);
68
+ }
69
+ return { verbs: [...verbs], own, unknown };
70
+ }
71
+ /** What `caller` (with `roles`) may do with `entity` under the app's rules. */
72
+ export function accessOf(entity, auth, caller) {
61
73
  const names = new Set([norm(entity.typeId), ...(entity.displayName ? [norm(entity.displayName)] : [])]);
62
74
  const rules = (auth?.access.rules ?? []).filter((r) => names.has(norm(r.model)));
63
- const publicGrant = rules.some((r) => PUBLIC_SUBJECTS.has(r.subject.trim().toLowerCase()) && READ_VERB.test(r.rule) && !OWN_WORD.test(r.rule));
64
- if (publicGrant)
65
- return 'project';
66
- if (rules.length > 0 || ownerFieldOf(entity) !== undefined || entity.scope === 'owner')
67
- return 'owner';
68
- return 'project';
75
+ if (rules.length === 0)
76
+ return OPEN;
77
+ const access = { create: 'none', list: 'none', view: 'none', update: 'none', delete: 'none', count: 'none' };
78
+ for (const r of rules) {
79
+ const subject = r.subject.trim();
80
+ const applies = subject === 'public' || (caller.principal !== undefined && (subject === 'member' || caller.roles.includes(subject)));
81
+ if (!applies)
82
+ continue;
83
+ const { verbs, own } = parseRule(r.rule);
84
+ for (const verb of verbs) {
85
+ // A visitor who is not signed in owns no record; `own` never limits create.
86
+ const reach = !own || verb === 'create' ? 'all' : caller.principal ? 'own' : 'none';
87
+ if (RANK[reach] > RANK[access[verb]])
88
+ access[verb] = reach;
89
+ }
90
+ }
91
+ return access;
69
92
  }
70
93
  const isEmpty = (v) => v === undefined || v === null || v === '';
71
94
  export class RecordStore {
@@ -107,20 +130,26 @@ export class RecordStore {
107
130
  this.collections.set(entity.typeId, rows);
108
131
  return rows;
109
132
  }
110
- /** Refuses a caller the declarations do not let in; answers the collection's scope. */
111
- guard({ entity, auth, caller }) {
133
+ /** What the caller may do here; refuses a caller the app does not let in at all. */
134
+ access({ entity, auth, caller }) {
112
135
  if (auth?.required && !caller.principal) {
113
136
  throw new HostError(401, 'SIGN_IN_REQUIRED', 'Sign in to use this app.');
114
137
  }
115
- const scope = scopeOf(entity, auth);
116
- if (scope === 'owner' && !caller.principal) {
117
- throw new HostError(401, 'SIGN_IN_REQUIRED', `Sign in to see your ${entity.displayName ?? entity.typeId} records.`);
118
- }
119
- return scope;
138
+ const roles = caller.principal?.id === this.devUser.id ? (auth?.access.roles ?? []) : [];
139
+ return accessOf(entity, auth, { principal: caller.principal, roles });
140
+ }
141
+ /** The reach of `verb`, refusing when it is none. */
142
+ allow(target, verb, access = this.access(target)) {
143
+ const reach = access[verb];
144
+ if (reach !== 'none')
145
+ return reach;
146
+ const name = target.entity.displayName ?? target.entity.typeId;
147
+ if (!target.caller.principal)
148
+ throw new HostError(401, 'SIGN_IN_REQUIRED', `Sign in to use ${name} records.`);
149
+ throw new HostError(403, 'FORBIDDEN', `You may not ${verb} ${name} records.`);
120
150
  }
121
- /** The rows this caller may see, newest change first, after `filter`. */
122
- visible(target, params) {
123
- const scope = this.guard(target);
151
+ /** The rows within `reach`, newest change first, after `filter`. */
152
+ rows(target, reach, params) {
124
153
  let filter;
125
154
  try {
126
155
  filter = parseFilter(params.get('filter'));
@@ -129,13 +158,14 @@ export class RecordStore {
129
158
  throw new HostError(400, 'INVALID_QUERY', 'filter must be a JSON filter object.');
130
159
  }
131
160
  const rows = [...this.collection(target.entity).values()]
132
- .filter((s) => scope === 'project' || s.owner === target.caller.principal?.id)
161
+ .filter((s) => reach === 'all' || s.owner === target.caller.principal?.id)
133
162
  .sort((a, b) => b.touched - a.touched)
134
163
  .map((s) => s.record);
135
- return { scope, rows: filter ? rows.filter((r) => matches(r, filter)) : rows };
164
+ return filter ? rows.filter((r) => matches(r, filter)) : rows;
136
165
  }
137
166
  list(target, params) {
138
- const { scope, rows } = this.visible(target, params);
167
+ const reach = this.allow(target, 'list');
168
+ const rows = this.rows(target, reach, params);
139
169
  const sort = parseSort(params.get('sort'));
140
170
  const ordered = sort.length > 0 ? sortRows(rows, sort) : rows;
141
171
  const limitRaw = Number(params.get('limit') ?? '100');
@@ -144,10 +174,10 @@ export class RecordStore {
144
174
  const offset = Number.isFinite(offsetRaw) ? Math.max(0, Math.trunc(offsetRaw)) : 0;
145
175
  return {
146
176
  data: ordered.slice(offset, offset + limit),
147
- meta: { total: ordered.length, scope, timestamp: new Date().toISOString() },
177
+ meta: { total: ordered.length, scope: reach === 'own' ? 'owner' : 'project', timestamp: new Date().toISOString() },
148
178
  };
149
179
  }
150
- /** `/count` (`plainCount`) or `/aggregate?fn&field`. */
180
+ /** `/count` (`plainCount`) or `/aggregate?fn&field`: over every row with `count`, else over the rows `list` reaches. */
151
181
  aggregate(target, params, plainCount) {
152
182
  const fn = plainCount ? 'count' : params.get('fn');
153
183
  if (fn !== 'count' && fn !== 'sum' && fn !== 'avg') {
@@ -156,26 +186,31 @@ export class RecordStore {
156
186
  const field = plainCount ? undefined : (params.get('field') ?? undefined);
157
187
  if (fn !== 'count' && !field)
158
188
  throw new HostError(400, 'INVALID_QUERY', `${fn} needs a field.`);
159
- const { scope, rows } = this.visible(target, params);
160
- return { data: aggregate(rows, fn, field), meta: { scope, timestamp: new Date().toISOString() } };
189
+ const access = this.access(target);
190
+ const reach = access.count === 'all' ? 'all' : this.allow(target, 'list', access);
191
+ const rows = this.rows(target, reach, params);
192
+ return {
193
+ data: aggregate(rows, fn, field),
194
+ meta: { scope: reach === 'own' ? 'owner' : 'project', timestamp: new Date().toISOString() },
195
+ };
161
196
  }
162
- find(target, id) {
163
- const scope = this.guard(target);
197
+ find(target, verb, id) {
198
+ const reach = this.allow(target, verb);
164
199
  const stored = this.collection(target.entity).get(id);
165
- if (!stored || (scope === 'owner' && stored.owner !== target.caller.principal?.id)) {
200
+ if (!stored || (reach === 'own' && stored.owner !== target.caller.principal?.id)) {
166
201
  throw new HostError(404, 'NOT_FOUND', `No ${target.entity.typeId} record "${id}".`);
167
202
  }
168
203
  return stored;
169
204
  }
170
205
  read(target, id) {
171
- return this.find(target, id).record;
206
+ return this.find(target, 'view', id).record;
172
207
  }
173
208
  create(target, body) {
174
209
  const { entity, caller } = target;
175
- const scope = this.guard(target);
210
+ this.allow(target, 'create');
176
211
  const fields = writable(body);
177
212
  const ownerField = ownerFieldOf(entity);
178
- if (scope === 'owner' && ownerField && isEmpty(fields[ownerField]) && caller.principal) {
213
+ if (ownerField && isEmpty(fields[ownerField]) && caller.principal) {
179
214
  fields[ownerField] = caller.principal.id;
180
215
  }
181
216
  const missing = entity.fields.filter((f) => f.required && isEmpty(fields[f.name])).map((f) => f.name);
@@ -189,7 +224,7 @@ export class RecordStore {
189
224
  return record;
190
225
  }
191
226
  update(target, id, body) {
192
- const stored = this.find(target, id);
227
+ const stored = this.find(target, 'update', id);
193
228
  const fields = writable(body);
194
229
  const cleared = target.entity.fields
195
230
  .filter((f) => f.required && f.name in fields && isEmpty(fields[f.name]))
@@ -208,7 +243,7 @@ export class RecordStore {
208
243
  return stored.record;
209
244
  }
210
245
  remove(target, id) {
211
- this.find(target, id);
246
+ this.find(target, 'delete', id);
212
247
  this.collection(target.entity).delete(id);
213
248
  }
214
249
  }
@@ -1 +1 @@
1
- {"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/host/records.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The app's own records, in memory (data-protocol §5).\n *\n * One collection per entity type declared in `app/definitions/entities.json`,\n * seeded on first use from `app/data/` (see `readSeed`). A record is\n * `{ …fields, id, entityType, createdAt, updatedAt }`, fields spread at the\n * top level like the reference server's.\n *\n * ACCESS, read off the declarations — a deliberately small version of what a\n * hosted session server decides:\n *\n * - `auth.json` `required: true`: every data request needs a session\n * (`401 SIGN_IN_REQUIRED`).\n * - A collection is OWNER-SCOPED when an `access.rules[]` entry names it and\n * is not a public read grant (subject `public`/`anyone`/`visitors`/…, a\n * rule that grants reading and does not say \"own\"), when the entity\n * declares an owner field (`owner`, `ownerId`, `userId`, `createdBy`, …),\n * or when the entity carries `\"scope\": \"owner\"`. An owner-scoped collection\n * needs a session, lists only the caller's rows, and answers another\n * visitor's row as `404`.\n * - Every other collection is shared by the whole app: anyone may read and\n * write it.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport { HostError } from './http.js'\nimport { readSeed, type AuthDeclaration, type EntityDeclaration } from './definitions.js'\nimport { aggregate, matches, parseFilter, parseSort, sortRows, type AggregateResult, type Filter, type Row } from './query.js'\nimport type { Principal } from './tokens.js'\n\nexport type Scope = 'project' | 'owner'\n\nconst PUBLIC_SUBJECTS = new Set([\n 'public',\n 'anyone',\n 'anybody',\n 'everyone',\n 'everybody',\n 'all',\n 'visitor',\n 'visitors',\n 'guest',\n 'guests',\n 'anonymous',\n '*',\n])\nconst READ_VERB = /\\b(read|reads|see|sees|view|views|list|lists|browse|browses)\\b/i\nconst OWN_WORD = /\\b(own|their|his|her|only)\\b/i\nconst OWNER_FIELDS = new Set([\n 'owner',\n 'ownerid',\n 'createdby',\n 'createdbyid',\n 'userid',\n 'memberid',\n 'authorid',\n 'principalid',\n 'accountid',\n])\nconst RESERVED = new Set(['id', 'entityType', 'createdAt', 'updatedAt', '__proto__', 'constructor', 'prototype'])\n\nconst norm = (s: string): string => s.toLowerCase().replace(/[\\s_-]/g, '')\n\nfunction ownerFieldOf(entity: EntityDeclaration): string | undefined {\n return entity.fields.find((f) => OWNER_FIELDS.has(norm(f.name)))?.name\n}\n\nexport function scopeOf(entity: EntityDeclaration, auth: AuthDeclaration | undefined): Scope {\n const names = new Set([norm(entity.typeId), ...(entity.displayName ? [norm(entity.displayName)] : [])])\n const rules = (auth?.access.rules ?? []).filter((r) => names.has(norm(r.model)))\n const publicGrant = rules.some(\n (r) => PUBLIC_SUBJECTS.has(r.subject.trim().toLowerCase()) && READ_VERB.test(r.rule) && !OWN_WORD.test(r.rule)\n )\n if (publicGrant) return 'project'\n if (rules.length > 0 || ownerFieldOf(entity) !== undefined || entity.scope === 'owner') return 'owner'\n return 'project'\n}\n\ninterface Stored {\n record: Row\n readonly owner: string | undefined\n touched: number\n}\n\nexport interface Caller {\n readonly principal: Principal | undefined\n}\n\nexport interface ListAnswer {\n readonly data: Row[]\n readonly meta: { readonly total: number; readonly scope: Scope; readonly timestamp: string }\n}\n\nexport interface AggregateAnswer {\n readonly data: AggregateResult\n readonly meta: { readonly scope: Scope; readonly timestamp: string }\n}\n\nconst isEmpty = (v: unknown): boolean => v === undefined || v === null || v === ''\n\n/** The data the request is about: which collection, under which declaration, for whom. */\nexport interface Target {\n readonly entity: EntityDeclaration\n readonly auth: AuthDeclaration | undefined\n readonly caller: Caller\n}\n\nexport class RecordStore {\n private readonly collections = new Map<string, Map<string, Stored>>()\n private clock = 0\n\n constructor(\n private readonly root: string,\n private readonly devUser: Principal\n ) {}\n\n reset(): void {\n this.collections.clear()\n this.clock = 0\n }\n\n private collection(entity: EntityDeclaration): Map<string, Stored> {\n let rows = this.collections.get(entity.typeId)\n if (rows) return rows\n rows = new Map()\n const now = new Date().toISOString()\n const ownerField = ownerFieldOf(entity)\n for (const seed of readSeed(this.root, entity.typeId)) {\n const id = typeof seed.id === 'string' || typeof seed.id === 'number' ? String(seed.id) : randomUUID()\n const declaredOwner = ownerField ? seed[ownerField] : undefined\n rows.set(id, {\n record: {\n ...seed,\n id,\n entityType: entity.typeId,\n createdAt: typeof seed.createdAt === 'string' ? seed.createdAt : now,\n updatedAt: typeof seed.updatedAt === 'string' ? seed.updatedAt : now,\n },\n // Seed rows belong to the development user unless they name an owner.\n owner: typeof declaredOwner === 'string' && declaredOwner ? declaredOwner : this.devUser.id,\n touched: ++this.clock,\n })\n }\n this.collections.set(entity.typeId, rows)\n return rows\n }\n\n /** Refuses a caller the declarations do not let in; answers the collection's scope. */\n private guard({ entity, auth, caller }: Target): Scope {\n if (auth?.required && !caller.principal) {\n throw new HostError(401, 'SIGN_IN_REQUIRED', 'Sign in to use this app.')\n }\n const scope = scopeOf(entity, auth)\n if (scope === 'owner' && !caller.principal) {\n throw new HostError(401, 'SIGN_IN_REQUIRED', `Sign in to see your ${entity.displayName ?? entity.typeId} records.`)\n }\n return scope\n }\n\n /** The rows this caller may see, newest change first, after `filter`. */\n private visible(target: Target, params: URLSearchParams): { scope: Scope; rows: Row[] } {\n const scope = this.guard(target)\n let filter: Filter | undefined\n try {\n filter = parseFilter(params.get('filter'))\n } catch {\n throw new HostError(400, 'INVALID_QUERY', 'filter must be a JSON filter object.')\n }\n const rows = [...this.collection(target.entity).values()]\n .filter((s) => scope === 'project' || s.owner === target.caller.principal?.id)\n .sort((a, b) => b.touched - a.touched)\n .map((s) => s.record)\n return { scope, rows: filter ? rows.filter((r) => matches(r, filter)) : rows }\n }\n\n list(target: Target, params: URLSearchParams): ListAnswer {\n const { scope, rows } = this.visible(target, params)\n const sort = parseSort(params.get('sort'))\n const ordered = sort.length > 0 ? sortRows(rows, sort) : rows\n const limitRaw = Number(params.get('limit') ?? '100')\n const offsetRaw = Number(params.get('offset') ?? '0')\n const limit = Number.isFinite(limitRaw) ? Math.min(500, Math.max(1, Math.trunc(limitRaw))) : 100\n const offset = Number.isFinite(offsetRaw) ? Math.max(0, Math.trunc(offsetRaw)) : 0\n return {\n data: ordered.slice(offset, offset + limit),\n meta: { total: ordered.length, scope, timestamp: new Date().toISOString() },\n }\n }\n\n /** `/count` (`plainCount`) or `/aggregate?fn&field`. */\n aggregate(target: Target, params: URLSearchParams, plainCount: boolean): AggregateAnswer {\n const fn = plainCount ? 'count' : params.get('fn')\n if (fn !== 'count' && fn !== 'sum' && fn !== 'avg') {\n throw new HostError(400, 'INVALID_QUERY', 'fn must be count, sum or avg.')\n }\n const field = plainCount ? undefined : (params.get('field') ?? undefined)\n if (fn !== 'count' && !field) throw new HostError(400, 'INVALID_QUERY', `${fn} needs a field.`)\n const { scope, rows } = this.visible(target, params)\n return { data: aggregate(rows, fn, field), meta: { scope, timestamp: new Date().toISOString() } }\n }\n\n private find(target: Target, id: string): Stored {\n const scope = this.guard(target)\n const stored = this.collection(target.entity).get(id)\n if (!stored || (scope === 'owner' && stored.owner !== target.caller.principal?.id)) {\n throw new HostError(404, 'NOT_FOUND', `No ${target.entity.typeId} record \"${id}\".`)\n }\n return stored\n }\n\n read(target: Target, id: string): Row {\n return this.find(target, id).record\n }\n\n create(target: Target, body: Record<string, unknown>): Row {\n const { entity, caller } = target\n const scope = this.guard(target)\n const fields = writable(body)\n const ownerField = ownerFieldOf(entity)\n if (scope === 'owner' && ownerField && isEmpty(fields[ownerField]) && caller.principal) {\n fields[ownerField] = caller.principal.id\n }\n const missing = entity.fields.filter((f) => f.required && isEmpty(fields[f.name])).map((f) => f.name)\n if (missing.length > 0) {\n throw new HostError(400, 'VALIDATION_FAILED', `Missing required field(s): ${missing.join(', ')}.`)\n }\n const now = new Date().toISOString()\n const id = randomUUID()\n const record: Row = { ...fields, id, entityType: entity.typeId, createdAt: now, updatedAt: now }\n this.collection(entity).set(id, { record, owner: caller.principal?.id, touched: ++this.clock })\n return record\n }\n\n update(target: Target, id: string, body: Record<string, unknown>): Row {\n const stored = this.find(target, id)\n const fields = writable(body)\n const cleared = target.entity.fields\n .filter((f) => f.required && f.name in fields && isEmpty(fields[f.name]))\n .map((f) => f.name)\n if (cleared.length > 0) {\n throw new HostError(400, 'VALIDATION_FAILED', `Required field(s) cannot be empty: ${cleared.join(', ')}.`)\n }\n stored.record = {\n ...stored.record,\n ...fields,\n id,\n entityType: target.entity.typeId,\n updatedAt: new Date().toISOString(),\n }\n stored.touched = ++this.clock\n return stored.record\n }\n\n remove(target: Target, id: string): void {\n this.find(target, id)\n this.collection(target.entity).delete(id)\n }\n}\n\n/** The record itself is the body; a lone `{ data: { … } }` wrapper is unwrapped. Server-owned members are dropped. */\nfunction writable(body: Record<string, unknown>): Record<string, unknown> {\n const keys = Object.keys(body)\n const inner = body.data\n const source =\n keys.length === 1 && keys[0] === 'data' && inner && typeof inner === 'object' && !Array.isArray(inner)\n ? (inner as Record<string, unknown>)\n : body\n const out: Record<string, unknown> = {}\n for (const [k, v] of Object.entries(source)) {\n if (!RESERVED.has(k)) out[k] = v\n }\n return out\n}\n"]}
1
+ {"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/host/records.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The app's own records, in memory (data-protocol §5).\n *\n * One collection per entity type declared in `app/definitions/entities.json`,\n * seeded on first use from `app/content/` then `app/data/` (see `readSeed`). A\n * record is `{ …fields, id, entityType, createdAt, updatedAt }`, fields spread\n * at the top level like the reference server's.\n *\n * ACCESS is the app's `auth.json` `access.rules` (definitions, `access`):\n *\n * - `required: true`: every data request needs a session (`401`).\n * - A model no rule names is open to every visitor.\n * - A model some rule names is closed: a request passes when a rule whose\n * subject matches the caller (`public`, `member`, or one of the caller's\n * roles) grants its verb. `own` limits the grant to the caller's records.\n * - Refused: `401 SIGN_IN_REQUIRED` without a session, `403 FORBIDDEN` with\n * one; a record outside an `own` grant is `404`.\n *\n * The development user carries every role `access.roles` declares, so the\n * author can try the app as staff; any other e-mail signs in as a plain member.\n */\n\nimport { randomUUID } from 'node:crypto'\nimport { HostError } from './http.js'\nimport { readSeed, type AuthDeclaration, type EntityDeclaration } from './definitions.js'\nimport { aggregate, matches, parseFilter, parseSort, sortRows, type AggregateResult, type Filter, type Row } from './query.js'\nimport type { Principal } from './tokens.js'\n\nexport type Scope = 'project' | 'owner'\n\ntype Verb = 'create' | 'list' | 'view' | 'update' | 'delete' | 'count'\n/** What one verb allows the caller: nothing, their own records, or every record. */\ntype Reach = 'none' | 'own' | 'all'\nexport type Access = Readonly<Record<Verb, Reach>>\n\nconst VERBS: Readonly<Record<string, readonly Verb[]>> = {\n create: ['create'],\n list: ['list'],\n view: ['view'],\n update: ['update'],\n delete: ['delete'],\n count: ['count'],\n read: ['list', 'view'],\n write: ['create', 'update', 'delete'],\n}\nconst OPEN: Access = { create: 'all', list: 'all', view: 'all', update: 'all', delete: 'all', count: 'all' }\nconst RANK: Readonly<Record<Reach, number>> = { none: 0, own: 1, all: 2 }\n\n/** Fields a record names its owner in; a create fills the first one when blank. */\nconst OWNER_FIELDS = new Set([\n 'owner',\n 'ownerid',\n 'createdby',\n 'createdbyid',\n 'userid',\n 'memberid',\n 'authorid',\n 'principalid',\n 'accountid',\n])\nconst RESERVED = new Set(['id', 'entityType', 'createdAt', 'updatedAt', '__proto__', 'constructor', 'prototype'])\n\nconst norm = (s: string): string => s.toLowerCase().replace(/[\\s_-]/g, '')\n\nfunction ownerFieldOf(entity: EntityDeclaration): string | undefined {\n return entity.fields.find((f) => OWNER_FIELDS.has(norm(f.name)))?.name\n}\n\n/** The words of a rule: verbs and `own`; anything else is ignored. */\nexport function parseRule(rule: string): { verbs: Verb[]; own: boolean; unknown: string[] } {\n const verbs = new Set<Verb>()\n const unknown: string[] = []\n let own = false\n for (const word of rule.toLowerCase().split(/[\\s,]+/).filter(Boolean)) {\n if (word === 'own') own = true\n else if (VERBS[word]) for (const v of VERBS[word]) verbs.add(v)\n else unknown.push(word)\n }\n return { verbs: [...verbs], own, unknown }\n}\n\n/** What `caller` (with `roles`) may do with `entity` under the app's rules. */\nexport function accessOf(\n entity: EntityDeclaration,\n auth: AuthDeclaration | undefined,\n caller: { readonly principal: Principal | undefined; readonly roles: readonly string[] }\n): Access {\n const names = new Set([norm(entity.typeId), ...(entity.displayName ? [norm(entity.displayName)] : [])])\n const rules = (auth?.access.rules ?? []).filter((r) => names.has(norm(r.model)))\n if (rules.length === 0) return OPEN\n const access: Record<Verb, Reach> = { create: 'none', list: 'none', view: 'none', update: 'none', delete: 'none', count: 'none' }\n for (const r of rules) {\n const subject = r.subject.trim()\n const applies =\n subject === 'public' || (caller.principal !== undefined && (subject === 'member' || caller.roles.includes(subject)))\n if (!applies) continue\n const { verbs, own } = parseRule(r.rule)\n for (const verb of verbs) {\n // A visitor who is not signed in owns no record; `own` never limits create.\n const reach: Reach = !own || verb === 'create' ? 'all' : caller.principal ? 'own' : 'none'\n if (RANK[reach] > RANK[access[verb]]) access[verb] = reach\n }\n }\n return access\n}\n\ninterface Stored {\n record: Row\n readonly owner: string | undefined\n touched: number\n}\n\nexport interface Caller {\n readonly principal: Principal | undefined\n}\n\nexport interface ListAnswer {\n readonly data: Row[]\n readonly meta: { readonly total: number; readonly scope: Scope; readonly timestamp: string }\n}\n\nexport interface AggregateAnswer {\n readonly data: AggregateResult\n readonly meta: { readonly scope: Scope; readonly timestamp: string }\n}\n\nconst isEmpty = (v: unknown): boolean => v === undefined || v === null || v === ''\n\n/** The data the request is about: which collection, under which declaration, for whom. */\nexport interface Target {\n readonly entity: EntityDeclaration\n readonly auth: AuthDeclaration | undefined\n readonly caller: Caller\n}\n\nexport class RecordStore {\n private readonly collections = new Map<string, Map<string, Stored>>()\n private clock = 0\n\n constructor(\n private readonly root: string,\n private readonly devUser: Principal\n ) {}\n\n reset(): void {\n this.collections.clear()\n this.clock = 0\n }\n\n private collection(entity: EntityDeclaration): Map<string, Stored> {\n let rows = this.collections.get(entity.typeId)\n if (rows) return rows\n rows = new Map()\n const now = new Date().toISOString()\n const ownerField = ownerFieldOf(entity)\n for (const seed of readSeed(this.root, entity.typeId)) {\n const id = typeof seed.id === 'string' || typeof seed.id === 'number' ? String(seed.id) : randomUUID()\n const declaredOwner = ownerField ? seed[ownerField] : undefined\n rows.set(id, {\n record: {\n ...seed,\n id,\n entityType: entity.typeId,\n createdAt: typeof seed.createdAt === 'string' ? seed.createdAt : now,\n updatedAt: typeof seed.updatedAt === 'string' ? seed.updatedAt : now,\n },\n // Seed rows belong to the development user unless they name an owner.\n owner: typeof declaredOwner === 'string' && declaredOwner ? declaredOwner : this.devUser.id,\n touched: ++this.clock,\n })\n }\n this.collections.set(entity.typeId, rows)\n return rows\n }\n\n /** What the caller may do here; refuses a caller the app does not let in at all. */\n private access({ entity, auth, caller }: Target): Access {\n if (auth?.required && !caller.principal) {\n throw new HostError(401, 'SIGN_IN_REQUIRED', 'Sign in to use this app.')\n }\n const roles = caller.principal?.id === this.devUser.id ? (auth?.access.roles ?? []) : []\n return accessOf(entity, auth, { principal: caller.principal, roles })\n }\n\n /** The reach of `verb`, refusing when it is none. */\n private allow(target: Target, verb: Verb, access = this.access(target)): Reach {\n const reach = access[verb]\n if (reach !== 'none') return reach\n const name = target.entity.displayName ?? target.entity.typeId\n if (!target.caller.principal) throw new HostError(401, 'SIGN_IN_REQUIRED', `Sign in to use ${name} records.`)\n throw new HostError(403, 'FORBIDDEN', `You may not ${verb} ${name} records.`)\n }\n\n /** The rows within `reach`, newest change first, after `filter`. */\n private rows(target: Target, reach: Reach, params: URLSearchParams): Row[] {\n let filter: Filter | undefined\n try {\n filter = parseFilter(params.get('filter'))\n } catch {\n throw new HostError(400, 'INVALID_QUERY', 'filter must be a JSON filter object.')\n }\n const rows = [...this.collection(target.entity).values()]\n .filter((s) => reach === 'all' || s.owner === target.caller.principal?.id)\n .sort((a, b) => b.touched - a.touched)\n .map((s) => s.record)\n return filter ? rows.filter((r) => matches(r, filter)) : rows\n }\n\n list(target: Target, params: URLSearchParams): ListAnswer {\n const reach = this.allow(target, 'list')\n const rows = this.rows(target, reach, params)\n const sort = parseSort(params.get('sort'))\n const ordered = sort.length > 0 ? sortRows(rows, sort) : rows\n const limitRaw = Number(params.get('limit') ?? '100')\n const offsetRaw = Number(params.get('offset') ?? '0')\n const limit = Number.isFinite(limitRaw) ? Math.min(500, Math.max(1, Math.trunc(limitRaw))) : 100\n const offset = Number.isFinite(offsetRaw) ? Math.max(0, Math.trunc(offsetRaw)) : 0\n return {\n data: ordered.slice(offset, offset + limit),\n meta: { total: ordered.length, scope: reach === 'own' ? 'owner' : 'project', timestamp: new Date().toISOString() },\n }\n }\n\n /** `/count` (`plainCount`) or `/aggregate?fn&field`: over every row with `count`, else over the rows `list` reaches. */\n aggregate(target: Target, params: URLSearchParams, plainCount: boolean): AggregateAnswer {\n const fn = plainCount ? 'count' : params.get('fn')\n if (fn !== 'count' && fn !== 'sum' && fn !== 'avg') {\n throw new HostError(400, 'INVALID_QUERY', 'fn must be count, sum or avg.')\n }\n const field = plainCount ? undefined : (params.get('field') ?? undefined)\n if (fn !== 'count' && !field) throw new HostError(400, 'INVALID_QUERY', `${fn} needs a field.`)\n const access = this.access(target)\n const reach = access.count === 'all' ? 'all' : this.allow(target, 'list', access)\n const rows = this.rows(target, reach, params)\n return {\n data: aggregate(rows, fn, field),\n meta: { scope: reach === 'own' ? 'owner' : 'project', timestamp: new Date().toISOString() },\n }\n }\n\n private find(target: Target, verb: Verb, id: string): Stored {\n const reach = this.allow(target, verb)\n const stored = this.collection(target.entity).get(id)\n if (!stored || (reach === 'own' && stored.owner !== target.caller.principal?.id)) {\n throw new HostError(404, 'NOT_FOUND', `No ${target.entity.typeId} record \"${id}\".`)\n }\n return stored\n }\n\n read(target: Target, id: string): Row {\n return this.find(target, 'view', id).record\n }\n\n create(target: Target, body: Record<string, unknown>): Row {\n const { entity, caller } = target\n this.allow(target, 'create')\n const fields = writable(body)\n const ownerField = ownerFieldOf(entity)\n if (ownerField && isEmpty(fields[ownerField]) && caller.principal) {\n fields[ownerField] = caller.principal.id\n }\n const missing = entity.fields.filter((f) => f.required && isEmpty(fields[f.name])).map((f) => f.name)\n if (missing.length > 0) {\n throw new HostError(400, 'VALIDATION_FAILED', `Missing required field(s): ${missing.join(', ')}.`)\n }\n const now = new Date().toISOString()\n const id = randomUUID()\n const record: Row = { ...fields, id, entityType: entity.typeId, createdAt: now, updatedAt: now }\n this.collection(entity).set(id, { record, owner: caller.principal?.id, touched: ++this.clock })\n return record\n }\n\n update(target: Target, id: string, body: Record<string, unknown>): Row {\n const stored = this.find(target, 'update', id)\n const fields = writable(body)\n const cleared = target.entity.fields\n .filter((f) => f.required && f.name in fields && isEmpty(fields[f.name]))\n .map((f) => f.name)\n if (cleared.length > 0) {\n throw new HostError(400, 'VALIDATION_FAILED', `Required field(s) cannot be empty: ${cleared.join(', ')}.`)\n }\n stored.record = {\n ...stored.record,\n ...fields,\n id,\n entityType: target.entity.typeId,\n updatedAt: new Date().toISOString(),\n }\n stored.touched = ++this.clock\n return stored.record\n }\n\n remove(target: Target, id: string): void {\n this.find(target, 'delete', id)\n this.collection(target.entity).delete(id)\n }\n}\n\n/** The record itself is the body; a lone `{ data: { … } }` wrapper is unwrapped. Server-owned members are dropped. */\nfunction writable(body: Record<string, unknown>): Record<string, unknown> {\n const keys = Object.keys(body)\n const inner = body.data\n const source =\n keys.length === 1 && keys[0] === 'data' && inner && typeof inner === 'object' && !Array.isArray(inner)\n ? (inner as Record<string, unknown>)\n : body\n const out: Record<string, unknown> = {}\n for (const [k, v] of Object.entries(source)) {\n if (!RESERVED.has(k)) out[k] = v\n }\n return out\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pwfabric/cli",
3
- "version": "1.0.0-rc.2",
3
+ "version": "1.1.0",
4
4
  "description": "The PWFabric command line: create, develop, validate, pack and run PWFabric applications without any hosted service",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",
@@ -35,13 +35,13 @@
35
35
  "node": ">=22"
36
36
  },
37
37
  "dependencies": {
38
- "@pwfabric/compiler": "1.0.0-rc.2",
39
- "@pwfabric/authoring": "1.0.0-rc.2",
40
- "@pwfabric/core": "1.0.0-rc.2",
41
- "@pwfabric/embed": "1.0.0-rc.2",
42
- "@pwfabric/pack": "1.0.0-rc.2",
43
- "@pwfabric/contracts": "1.0.0-rc.2",
44
- "@pwfabric/runner": "1.0.0-rc.2"
38
+ "@pwfabric/authoring": "1.1.0",
39
+ "@pwfabric/compiler": "1.1.0",
40
+ "@pwfabric/core": "1.1.0",
41
+ "@pwfabric/contracts": "1.1.0",
42
+ "@pwfabric/embed": "1.1.0",
43
+ "@pwfabric/pack": "1.1.0",
44
+ "@pwfabric/runner": "1.1.0"
45
45
  },
46
46
  "devDependencies": {
47
47
  "@types/node": "^22.0.0",