foldkit-guard 0.2.0 → 0.3.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.
- package/README.md +65 -3
- package/dist/agent.d.mts +1 -1
- package/dist/{attach-BdHNdPNM.d.mts → attach-BVG6LsFf.d.mts} +71 -4
- package/dist/attach-BVG6LsFf.d.mts.map +1 -0
- package/dist/{attach-COgJIox7.mjs → attach-BZyVvs7H.mjs} +21 -6
- package/dist/attach-BZyVvs7H.mjs.map +1 -0
- package/dist/{condition-C6Czs2Xn.mjs → condition-Dunujvzy.mjs} +2 -2
- package/dist/{condition-C6Czs2Xn.mjs.map → condition-Dunujvzy.mjs.map} +1 -1
- package/dist/drizzle.d.mts +1 -1
- package/dist/drizzle.mjs +2 -2
- package/dist/index.d.mts +2 -2
- package/dist/index.mjs +37 -6
- package/dist/index.mjs.map +1 -1
- package/dist/me-DeSZOGt3.mjs +40 -0
- package/dist/me-DeSZOGt3.mjs.map +1 -0
- package/dist/origin-CN6ThFTp.mjs +13 -0
- package/dist/origin-CN6ThFTp.mjs.map +1 -0
- package/dist/{placed-Bs_mnBTF.mjs → placed-CkyMqxFw.mjs} +4 -3
- package/dist/placed-CkyMqxFw.mjs.map +1 -0
- package/dist/server.d.mts +11 -1
- package/dist/server.d.mts.map +1 -1
- package/dist/server.mjs +34 -3
- package/dist/server.mjs.map +1 -1
- package/dist/sync.d.mts +1 -1
- package/dist/sync.mjs +5 -5
- package/dist/sync.mjs.map +1 -1
- package/package.json +13 -13
- package/dist/attach-BdHNdPNM.d.mts.map +0 -1
- package/dist/attach-COgJIox7.mjs.map +0 -1
- package/dist/placed-Bs_mnBTF.mjs.map +0 -1
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Who may do what, declared once on the domain.\n *\n * A guard set names its guards once, in shared code the client imports too.\n * A **principal guard** is declared by name and implemented only on the\n * server (`G.implement`), so its logic never ships. A **row guard** is an\n * `Expr` over one Entity's fields with the principal's fields as inputs: data,\n * which the SQL compiler and `evaluate` both run. See `guard-DESIGN.md`.\n */\nimport { Context, Effect, Match, Option, Schema } from 'effect'\nimport { Attaching, attached, type InteractionKey } from './attach.js'\nimport {\n deciding,\n readsPrincipal,\n type Condition,\n type MemberRead,\n type RowRule,\n} from './condition.js'\nimport { May } from './may.js'\nimport {\n Expr,\n Query,\n evaluate,\n type AnyEntity,\n type AnyQuery,\n type InputExpr,\n type Predicate,\n} from 'foldkit-entity'\n\n/** A guard's answer: allowed, refused, or refused with a sentence the caller may read. */\nexport type Decision = boolean | { readonly allowed: false; readonly reason: string }\n\n/** What a principal guard is asked about. */\nexport interface About {\n /** The interaction attempted: `Read`, `Update`, or one the application names. */\n readonly interaction: string\n}\n\n/**\n * The principal's fields as a row guard's body sees them: each an input named\n * `principal.<field>`, typed as the field. A body is built once, so it holds\n * these placeholders and never a value: branching on one is a type error.\n */\nexport type Placeholders<User> = {\n readonly [K in keyof User & string]: InputExpr<User[K]>\n}\n\n/** What `guard.principal()` declares: a name whose body the server supplies. */\nexport interface PrincipalSpec {\n readonly _tag: 'PrincipalSpec'\n}\n\n/** What `guard.row(entity, body)` declares: a predicate over one Entity's rows. */\nexport interface RowSpec<E extends AnyEntity> {\n readonly _tag: 'RowSpec'\n readonly entity: E\n readonly body: Predicate\n}\n\ntype AnySpec = PrincipalSpec | RowSpec<AnyEntity>\n\n/**\n * The principal a guard is for, kept in the type so a guard of one principal\n * cannot stand where another's is wanted. A function type, so it is invariant.\n */\ninterface ForPrincipal<User> {\n readonly '~principal'?: (user: User) => User\n}\n\n/** A guard whose body lives on the server, asked of the principal alone. */\nexport interface PrincipalGuard<User, Set extends string = string> extends ForPrincipal<User> {\n readonly _tag: 'PrincipalGuard'\n readonly name: string\n /** The name of the guard set it belongs to. */\n readonly set: Set\n}\n\n/** A guard over the rows of `E`: its predicate, and the query that asks it of rows. */\nexport interface RowGuard<\n User,\n E extends AnyEntity,\n Set extends string = string,\n> extends ForPrincipal<User> {\n readonly _tag: 'RowGuard'\n readonly name: string\n readonly set: Set\n readonly entity: E\n readonly body: Predicate\n /** `from(entity).where(body)`, for an interpreter that runs queries. */\n readonly query: AnyQuery\n}\n\nexport type AnyGuard<User> = PrincipalGuard<User> | RowGuard<User, AnyEntity>\n\ntype GuardOf<User, Set extends string, S> =\n S extends RowSpec<infer E> ? RowGuard<User, E, Set> : PrincipalGuard<User, Set>\n\n/** The keys of a spec record that are principal guards: what `implement` must supply. */\ntype PrincipalKeys<S> = { [K in keyof S]: S[K] extends PrincipalSpec ? K : never }[keyof S]\n\n/** A principal guard's body, on the server. */\nexport type Body<User, R = never> = (\n principal: Option.Option<User>,\n about: About,\n) => Decision | Effect.Effect<Decision, never, R>\n\n/** Names a guard set reserves for itself, which no guard may take. */\nconst reserved = [\n 'name',\n 'schema',\n 'Principal',\n 'key',\n 'unguarded',\n 'inputOf',\n 'implement',\n] as const\ntype Reserved = (typeof reserved)[number]\n\n/** Who is asking, for one guard set: a visitor is `none`. */\nexport interface PrincipalOf<Name extends string> {\n readonly '~guardSet': Name\n}\n\n/** The guard set of one application, as `Guards.declare` returns it. */\nexport type GuardSet<Name extends string, User, S> = {\n readonly [K in keyof S]: GuardOf<User, Name, S[K]>\n} & {\n readonly name: Name\n /** The principal's schema, whose fields the row guards read. */\n readonly schema: Schema.Codec<User, unknown>\n /** The server's Context key for who is asking. Authentication provides it. */\n readonly Principal: Context.Service<PrincipalOf<Name>, Option.Option<User>>\n /** A stable name for the person, whatever their claims: for what is theirs, as a cache's scope. */\n readonly key: (user: User) => string\n readonly unguarded: 'allow' | 'deny'\n /** The principal's fields as row guards' inputs, encoded as stored values are. */\n readonly inputOf: (user: User) => Readonly<Record<string, unknown>>\n /** The bodies of the principal guards: every one, and nothing else. */\n readonly implement: <R = never>(bodies: {\n readonly [K in PrincipalKeys<S>]: Body<User, R>\n }) => Policy<User, R>\n}\n\n/** The server's half of a guard set: every principal guard's body. */\nexport interface Policy<User, R = never> {\n readonly set: string\n /**\n * Whether `guard` allows `principal`, for a row guard over `row` (its stored,\n * encoded values). A visitor passes no row guard that reads a principal's\n * fields; one over the row alone holds for a visitor too.\n */\n readonly decide: (\n guard: AnyGuard<User>,\n request: {\n readonly principal: Option.Option<User>\n readonly interaction: string\n readonly row?: Readonly<Record<string, unknown>> | undefined\n },\n ) => Effect.Effect<Decision, never, R>\n /**\n * Which rows of `entity` `principal` may read, as a condition over the row\n * with every principal guard already decided. An Entity without guards, or\n * of no set, reads `Always`.\n */\n readonly readable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n ) => Effect.Effect<Condition, never, R>\n /** The read rule of each of `members`, relations included, that has one, decided for `principal`. */\n readonly readMembers: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n members: ReadonlyArray<string>,\n ) => Effect.Effect<ReadonlyArray<MemberRead>, never, R>\n /**\n * Which rows of `entity` `principal` may write by `interaction` (`Create`,\n * `Update`, `Delete`, or one the application named), as a condition over\n * the row, and what a refusal shows.\n */\n readonly writable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n interaction: 'Create' | 'Update' | 'Delete' | InteractionKey,\n ) => Effect.Effect<RowRule, never, R>\n /** The rule of each of `members` that has one for setting it, decided for `principal`. */\n readonly writeMembers: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n members: ReadonlyArray<string>,\n interaction: 'Create' | 'Update',\n ) => Effect.Effect<ReadonlyArray<MemberRead>, never, R>\n /** A relation's rule for linking or unlinking a row, when it has one. */\n readonly linkable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n relation: string,\n interaction: 'Link' | 'Unlink',\n ) => Effect.Effect<Option.Option<RowRule>, never, R>\n /** The principal's fields as row guards' inputs; a visitor has none. */\n readonly inputOf: (principal: Option.Option<User>) => Readonly<Record<string, unknown>>\n /**\n * Who is asking, as the rules see it: every field of the principal, encoded,\n * a visitor included. Two requests by one person with the same claims answer\n * alike, so a live hub shares their re-reads; a changed claim is not shared.\n *\n * ```ts\n * RemoteServer.liveHub(sources, { key: Policy.keyOf })\n * ```\n */\n readonly keyOf: (principal: Option.Option<User>) => string\n /**\n * Whether `value` is this set's principal, an `Option` of its schema: for a\n * seam that is handed the principal untyped.\n */\n readonly isPrincipal: (value: unknown) => value is Option.Option<User>\n}\n\n/** The builders a guard set's declaration is given, typed by its principal. */\nexport interface Builders<User> {\n /** A guard decided from the principal alone, by a body only the server has. */\n readonly principal: () => PrincipalSpec\n /** A guard over `entity`'s rows: a predicate with the principal's fields as inputs. */\n readonly row: <E extends AnyEntity>(\n entity: E,\n body: (principal: Placeholders<User>) => Predicate,\n ) => RowSpec<E>\n}\n\nconst placeholdersOf = <User>(fields: Schema.Struct.Fields): Placeholders<User> => {\n const inputs: Record<string, InputExpr<unknown>> = {}\n for (const key of Object.keys(fields)) {\n inputs[key] = Expr.input(\n `principal.${key}`,\n fields[key] as unknown as Schema.Codec<unknown, unknown>,\n )\n }\n return Object.freeze(inputs) as Placeholders<User>\n}\n\nexport { Condition, type MemberRead, type RowRule } from './condition.js'\nexport { May, MaySchema, type MayAnswer } from './may.js'\nexport {\n Interaction,\n type All,\n type AnyRule,\n type Attach,\n type Attachment,\n type Deny,\n type Explain,\n type Inherit,\n type InteractionKey,\n type On,\n type Redact,\n type RuleFor,\n type Surface,\n} from './attach.js'\n\nexport const Guards = {\n ...Attaching,\n /**\n * Adds the `may` member, the server's answer to what a principal may do\n * with a row, after its guards are attached:\n * `TodoFields.pipe(Guards.attach(G, { … }), Guards.may)`.\n */\n may: May.member,\n /**\n * One application's guards, under `name` (its principal's Context key, and\n * what the matrix prints). `principal` is a `Schema.Struct`: its fields are\n * what a row guard reads, and its codec encodes a principal's values as\n * stored values are encoded.\n *\n * ```ts\n * const G = Guards.declare('Todos', User, guard => ({\n * isAdmin: guard.principal(),\n * isOwner: guard.row(TodoFields, p => Expr.eq(TodoFields.fields.ownerId, p.id)),\n * }), { key: user => user.id })\n * ```\n */\n declare: <\n const Name extends string,\n Fields extends Schema.Struct.Fields,\n const S extends Readonly<Record<string, AnySpec>> & { readonly [K in Reserved]?: never },\n >(\n name: Name,\n principal: Schema.Struct<Fields>,\n build: (guard: Builders<Schema.Struct.Type<Fields>>) => S,\n options: {\n readonly key: (user: Schema.Struct.Type<Fields>) => string\n readonly unguarded?: 'allow' | 'deny' | undefined\n },\n ): GuardSet<Name, Schema.Struct.Type<Fields>, S> => {\n type User = Schema.Struct.Type<Fields>\n const placeholders = placeholdersOf<User>(principal.fields)\n const specs = build({\n principal: () => Object.freeze({ _tag: 'PrincipalSpec' }),\n row: (entity, body) => Object.freeze({ _tag: 'RowSpec', entity, body: body(placeholders) }),\n })\n const guards: Record<string, AnyGuard<User>> = Object.create(null)\n for (const [guard, spec] of Object.entries(specs)) {\n if ((reserved as ReadonlyArray<string>).includes(guard)) {\n throw new Error(\n `[foldkit-guard] ${name}: \"${guard}\" is a name the guard set keeps for itself`,\n )\n }\n guards[guard] = Match.valueTags(spec, {\n PrincipalSpec: (): AnyGuard<User> =>\n Object.freeze({ _tag: 'PrincipalGuard', name: guard, set: name }),\n RowSpec: ({ entity, body }): AnyGuard<User> =>\n Object.freeze({\n _tag: 'RowGuard',\n name: guard,\n set: name,\n entity,\n body,\n // Checks the body reads only this Entity's fields, where it is declared.\n query: Query.from(entity).pipe(Query.where(body)),\n }),\n })\n }\n const principalNames = Object.keys(guards).filter(\n guard => guards[guard]!._tag === 'PrincipalGuard',\n )\n const encoders = Object.fromEntries(\n Object.entries(principal.fields).map(([field, schema]) => [\n field,\n Schema.encodeSync(schema as unknown as Schema.Codec<unknown, unknown>),\n ]),\n )\n const inputOf = (user: User): Readonly<Record<string, unknown>> => {\n const input: Record<string, unknown> = {}\n for (const [field, encode] of Object.entries(encoders)) {\n input[`principal.${field}`] = encode((user as Record<string, unknown>)[field])\n }\n return input\n }\n\n const isPrincipal = Schema.is(Schema.Option(principal))\n // Every claim as JSON keeps it, a set, a number past JSON's or a date\n // included: two principals that differ in one never share a key.\n const asJson = Schema.encodeSync(\n Schema.toCodecJson(principal) as unknown as Schema.Codec<unknown, unknown>,\n )\n\n const implement = <R>(bodies: Readonly<Record<string, Body<User, R>>>): Policy<User, R> => {\n const missing = principalNames.filter(guard => !Object.hasOwn(bodies, guard))\n const extra = Object.keys(bodies).filter(guard => !principalNames.includes(guard))\n if (missing.length > 0 || extra.length > 0) {\n throw new Error(\n `[foldkit-guard] ${name}.implement: ${[\n missing.length > 0 ? `no body for ${missing.join(', ')}` : '',\n extra.length > 0 ? `${extra.join(', ')} is not a principal guard` : '',\n ]\n .filter(part => part !== '')\n .join('; ')}`,\n )\n }\n const decide: Policy<User, R>['decide'] = (guard, { principal, interaction, row }) => {\n if (guard.set !== name) {\n return Effect.die(\n new Error(`[foldkit-guard] ${name}: \"${guard.name}\" belongs to ${guard.set}`),\n )\n }\n return Match.valueTags(guard, {\n PrincipalGuard: ({ name: body }) => {\n const decided = bodies[body]!(principal, { interaction })\n return Effect.isEffect(decided) ? decided : Effect.succeed(decided)\n },\n RowGuard: rowGuard =>\n Effect.succeed(\n row !== undefined &&\n Option.match(principal, {\n // A visitor has no fields: only a guard over the row alone can hold.\n onNone: () =>\n !readsPrincipal(rowGuard) && evaluate(rowGuard.query, {}, [row]).length === 1,\n onSome: user => evaluate(rowGuard.query, inputOf(user), [row]).length === 1,\n }),\n ),\n })\n }\n const decidingFor = (\n entity: AnyEntity,\n principal: Option.Option<User>,\n interaction: string,\n ) => {\n Option.map(attached(entity), ({ set }) => {\n if (set !== name) {\n throw new Error(`[foldkit-guard] ${name}: ${entity.name} carries the guards of ${set}`)\n }\n })\n return deciding(\n guard =>\n Effect.map(decide(guard, { principal, interaction }), decision => decision === true),\n Option.isNone(principal),\n interaction,\n )\n }\n return {\n set: name,\n decide,\n readable: (entity, principal) =>\n Effect.map(\n decidingFor(entity, principal, 'Read').row(entity),\n ({ condition }) => condition,\n ),\n readMembers: (entity, principal, members) =>\n decidingFor(entity, principal, 'Read').members(entity, members),\n writable: (entity, principal, interaction) =>\n decidingFor(entity, principal, interaction).row(entity),\n writeMembers: (entity, principal, members, interaction) =>\n decidingFor(entity, principal, interaction).members(entity, members),\n linkable: (entity, principal, relation, interaction) =>\n decidingFor(entity, principal, interaction).relation(entity, relation),\n inputOf: principal =>\n Option.match(principal, { onNone: () => ({}), onSome: user => inputOf(user) }),\n // Prefixed, so no user's key is the visitor's. Not `declare`'s `key`\n // alone: a re-read shared under it would read a newer request as an\n // older one's claims.\n keyOf: principal =>\n Option.match(principal, {\n onNone: () => 'visitor',\n onSome: user => `user:${JSON.stringify(asJson(user))}`,\n }),\n isPrincipal,\n }\n }\n\n return Object.freeze({\n ...guards,\n name,\n schema: principal as unknown as Schema.Codec<User, unknown>,\n Principal: Context.Service<PrincipalOf<Name>, Option.Option<User>>(\n `foldkit-guard/Principal/${name}`,\n ),\n key: options.key,\n unguarded: options.unguarded ?? 'allow',\n inputOf,\n implement,\n }) as unknown as GuardSet<Name, User, S>\n },\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Who may do what, declared once on the domain.\n *\n * A guard set names its guards once, in shared code the client imports too.\n * A **principal guard** is declared by name and implemented only on the\n * server (`G.implement`), so its logic never ships. A **row guard** is an\n * `Expr` over one Entity's fields with the principal's fields as inputs: data,\n * which the SQL compiler and `evaluate` both run. See `guard-DESIGN.md`.\n */\nimport { Context, Effect, Match, Option, Schema } from 'effect'\nimport { Attaching, attached, type InteractionKey } from './attach.js'\nimport {\n deciding,\n readsPrincipal,\n type Condition,\n type MemberRead,\n type RowRule,\n} from './condition.js'\nimport { May } from './may.js'\nimport { me } from './me.js'\nimport { providedFrom } from './origin.js'\nimport {\n Expr,\n Query,\n evaluate,\n type AnyEntity,\n type AnyQuery,\n type InputExpr,\n type Predicate,\n} from 'foldkit-entity'\n\n/** A guard's answer: allowed, refused, or refused with a sentence the caller may read. */\nexport type Decision = boolean | { readonly allowed: false; readonly reason: string }\n\n/** What a principal guard is asked about. */\nexport interface About {\n /** The interaction attempted: `Read`, `Update`, or one the application names. */\n readonly interaction: string\n}\n\n/**\n * The principal's fields as a row guard's body sees them: each an input named\n * `principal.<field>`, typed as the field. A body is built once, so it holds\n * these placeholders and never a value: branching on one is a type error.\n */\nexport type Placeholders<User> = {\n readonly [K in keyof User & string]: InputExpr<User[K]>\n}\n\n/** What `guard.principal()` declares: a name whose body the server supplies. */\nexport interface PrincipalSpec {\n readonly _tag: 'PrincipalSpec'\n}\n\n/** What `guard.row(entity, body)` declares: a predicate over one Entity's rows. */\nexport interface RowSpec<E extends AnyEntity> {\n readonly _tag: 'RowSpec'\n readonly entity: E\n readonly body: Predicate\n}\n\ntype AnySpec = PrincipalSpec | RowSpec<AnyEntity>\n\n/**\n * The principal a guard is for, kept in the type so a guard of one principal\n * cannot stand where another's is wanted. A function type, so it is invariant.\n */\ninterface ForPrincipal<User> {\n readonly '~principal'?: (user: User) => User\n}\n\n/** A guard whose body lives on the server, asked of the principal alone. */\nexport interface PrincipalGuard<User, Set extends string = string> extends ForPrincipal<User> {\n readonly _tag: 'PrincipalGuard'\n readonly name: string\n /** The name of the guard set it belongs to. */\n readonly set: Set\n}\n\n/** A guard over the rows of `E`: its predicate, and the query that asks it of rows. */\nexport interface RowGuard<\n User,\n E extends AnyEntity,\n Set extends string = string,\n> extends ForPrincipal<User> {\n readonly _tag: 'RowGuard'\n readonly name: string\n readonly set: Set\n readonly entity: E\n readonly body: Predicate\n /** `from(entity).where(body)`, for an interpreter that runs queries. */\n readonly query: AnyQuery\n}\n\nexport type AnyGuard<User> = PrincipalGuard<User> | RowGuard<User, AnyEntity>\n\ntype GuardOf<User, Set extends string, S> =\n S extends RowSpec<infer E> ? RowGuard<User, E, Set> : PrincipalGuard<User, Set>\n\n/** The keys of a spec record that are principal guards: what `implement` must supply. */\ntype PrincipalKeys<S> = { [K in keyof S]: S[K] extends PrincipalSpec ? K : never }[keyof S]\n\n/** A principal guard's body, on the server. */\nexport type Body<User, R = never> = (\n principal: Option.Option<User>,\n about: About,\n) => Decision | Effect.Effect<Decision, never, R>\n\n/** Names a guard set reserves for itself, which no guard may take. */\nconst reserved = [\n 'name',\n 'schema',\n 'Principal',\n 'key',\n 'unguarded',\n 'inputOf',\n 'implement',\n] as const\ntype Reserved = (typeof reserved)[number]\n\n/** Who is asking, for one guard set: a visitor is `none`. */\nexport interface PrincipalOf<Name extends string> {\n readonly '~guardSet': Name\n}\n\n/** The guard set of one application, as `Guards.declare` returns it. */\nexport type GuardSet<Name extends string, User, S> = {\n readonly [K in keyof S]: GuardOf<User, Name, S[K]>\n} & {\n readonly name: Name\n /** The principal's schema, whose fields the row guards read. */\n readonly schema: Schema.Codec<User, unknown>\n /** The server's Context key for who is asking. Authentication provides it. */\n readonly Principal: Context.Service<PrincipalOf<Name>, Option.Option<User>>\n /** A stable name for the person, whatever their claims: for what is theirs, as a cache's scope. */\n readonly key: (user: User) => string\n readonly unguarded: 'allow' | 'deny'\n /** The principal's fields as row guards' inputs, encoded as stored values are. */\n readonly inputOf: (user: User) => Readonly<Record<string, unknown>>\n /** The bodies of the principal guards: every one, and nothing else. */\n readonly implement: <R = never>(bodies: {\n readonly [K in PrincipalKeys<S>]: Body<User, R>\n }) => Policy<User, R>\n}\n\n/** The server's half of a guard set: every principal guard's body. */\nexport interface Policy<User, R = never> {\n readonly set: string\n /**\n * Whether `guard` allows `principal`, for a row guard over `row` (its stored,\n * encoded values). A visitor passes no row guard that reads a principal's\n * fields; one over the row alone holds for a visitor too.\n */\n readonly decide: (\n guard: AnyGuard<User>,\n request: {\n readonly principal: Option.Option<User>\n readonly interaction: string\n readonly row?: Readonly<Record<string, unknown>> | undefined\n },\n ) => Effect.Effect<Decision, never, R>\n /**\n * Which rows of `entity` `principal` may read, as a condition over the row\n * with every principal guard already decided. An Entity without guards, or\n * of no set, reads `Always`.\n */\n readonly readable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n ) => Effect.Effect<Condition, never, R>\n /** The read rule of each of `members`, relations included, that has one, decided for `principal`. */\n readonly readMembers: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n members: ReadonlyArray<string>,\n ) => Effect.Effect<ReadonlyArray<MemberRead>, never, R>\n /**\n * Which rows of `entity` `principal` may write by `interaction` (`Create`,\n * `Update`, `Delete`, or one the application named), as a condition over\n * the row, and what a refusal shows.\n */\n readonly writable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n interaction: 'Create' | 'Update' | 'Delete' | InteractionKey,\n ) => Effect.Effect<RowRule, never, R>\n /** The rule of each of `members` that has one for setting it, decided for `principal`. */\n readonly writeMembers: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n members: ReadonlyArray<string>,\n interaction: 'Create' | 'Update',\n ) => Effect.Effect<ReadonlyArray<MemberRead>, never, R>\n /** A relation's rule for linking or unlinking a row, when it has one. */\n readonly linkable: (\n entity: AnyEntity,\n principal: Option.Option<User>,\n relation: string,\n interaction: 'Link' | 'Unlink',\n ) => Effect.Effect<Option.Option<RowRule>, never, R>\n /** The principal's fields as row guards' inputs; a visitor has none. */\n readonly inputOf: (principal: Option.Option<User>) => Readonly<Record<string, unknown>>\n /**\n * Who the principal is: `declare`'s `key`, the same function as `G.key`,\n * here for a server seam that holds the Policy and not the set. Not\n * `keyOf`, which names a principal by every field, for sharing re-reads.\n */\n readonly key: (user: User) => string\n /**\n * Who is asking, as the rules see it: every field of the principal, encoded,\n * a visitor included. Two requests by one person with the same claims answer\n * alike, so a live hub shares their re-reads; a changed claim is not shared.\n *\n * ```ts\n * RemoteServer.liveHub(sources, { key: Policy.keyOf })\n * ```\n */\n readonly keyOf: (principal: Option.Option<User>) => string\n /**\n * Whether `value` is this set's principal, an `Option` of its schema: for a\n * seam that is handed the principal untyped.\n */\n readonly isPrincipal: (value: unknown) => value is Option.Option<User>\n /**\n * This Policy with services its bodies need provided, such as a membership\n * lookup. The read seams (`GuardDrizzle.visible`, `GuardServer.memory`,\n * `GuardSync`) take a Policy that needs nothing more: a read rule runs inside\n * a read whose requirements are its Source's. Provide what stays put here,\n * once; carry what changes per request in the principal. A seam built from\n * the result counts as built from this Policy: `validate` checks the rules,\n * not the services given them. `GuardSync.authorize` runs bodies\n * synchronously, so what it is given must answer without suspending.\n *\n * ```ts\n * const ReadPolicy = Policy.provide(Context.make(Memberships, memberships))\n * ```\n */\n readonly provide: <Provided extends R>(\n context: Context.Context<Provided>,\n ) => Policy<User, Exclude<R, Provided>>\n}\n\n/** `policy` with `context` provided to every body it runs. */\nconst provided = <User, R, Provided extends R>(\n policy: Policy<User, R>,\n context: Context.Context<Provided>,\n): Policy<User, Exclude<R, Provided>> => {\n const run = <A>(effect: Effect.Effect<A, never, R>) => Effect.provide(effect, context)\n const next: Policy<User, Exclude<R, Provided>> = {\n ...policy,\n decide: (guard, request) => run(policy.decide(guard, request)),\n readable: (entity, principal) => run(policy.readable(entity, principal)),\n readMembers: (entity, principal, members) =>\n run(policy.readMembers(entity, principal, members)),\n writable: (entity, principal, interaction) =>\n run(policy.writable(entity, principal, interaction)),\n writeMembers: (entity, principal, members, interaction) =>\n run(policy.writeMembers(entity, principal, members, interaction)),\n linkable: (entity, principal, relation, interaction) =>\n run(policy.linkable(entity, principal, relation, interaction)),\n provide: more => provided(next, more),\n }\n return providedFrom(next, policy)\n}\n\n/** The builders a guard set's declaration is given, typed by its principal. */\nexport interface Builders<User> {\n /** A guard decided from the principal alone, by a body only the server has. */\n readonly principal: () => PrincipalSpec\n /** A guard over `entity`'s rows: a predicate with the principal's fields as inputs. */\n readonly row: <E extends AnyEntity>(\n entity: E,\n body: (principal: Placeholders<User>) => Predicate,\n ) => RowSpec<E>\n}\n\nconst placeholdersOf = <User>(fields: Schema.Struct.Fields): Placeholders<User> => {\n const inputs: Record<string, InputExpr<unknown>> = {}\n for (const key of Object.keys(fields)) {\n inputs[key] = Expr.input(\n `principal.${key}`,\n fields[key] as unknown as Schema.Codec<unknown, unknown>,\n )\n }\n return Object.freeze(inputs) as Placeholders<User>\n}\n\nexport { Condition, type MemberRead, type RowRule } from './condition.js'\nexport { May, MaySchema, type MayAnswer } from './may.js'\nexport { ME, type MeEntity } from './me.js'\nexport {\n Interaction,\n type All,\n type AnyRule,\n type Attach,\n type Attachment,\n type Deny,\n type Explain,\n type Inherit,\n type InteractionKey,\n type On,\n type Redact,\n type RuleFor,\n type Surface,\n} from './attach.js'\n\nexport const Guards = {\n ...Attaching,\n /**\n * Adds the `may` member, the server's answer to what a principal may do\n * with a row, after its guards are attached:\n * `TodoFields.pipe(Guards.attach(G, { … }), Guards.may)`.\n */\n may: May.member,\n /**\n * `Me`, the visitor as an Entity: one row, `me`, that everyone reads and no\n * one writes, with `signedIn`, the principal's `key`, and `may` for the\n * interactions named here. Serve it with `GuardServer.me`.\n *\n * ```ts\n * export const Me = Guards.me(G, { interactions: { [OpenAdmin.key]: [G.isAdmin] } })\n * ```\n */\n me,\n /**\n * One application's guards, under `name` (its principal's Context key, and\n * what the matrix prints). `principal` is a `Schema.Struct`: its fields are\n * what a row guard reads, and its codec encodes a principal's values as\n * stored values are encoded.\n *\n * ```ts\n * const G = Guards.declare('Todos', User, guard => ({\n * isAdmin: guard.principal(),\n * isOwner: guard.row(TodoFields, p => Expr.eq(TodoFields.fields.ownerId, p.id)),\n * }), { key: user => user.id })\n * ```\n */\n declare: <\n const Name extends string,\n Fields extends Schema.Struct.Fields,\n const S extends Readonly<Record<string, AnySpec>> & { readonly [K in Reserved]?: never },\n >(\n name: Name,\n principal: Schema.Struct<Fields>,\n build: (guard: Builders<Schema.Struct.Type<Fields>>) => S,\n options: {\n readonly key: (user: Schema.Struct.Type<Fields>) => string\n /**\n * What a surface of a guarded Entity with no rules decides: `'deny'`\n * refuses it, `'allow'` lets everyone. Required, so an open surface is\n * a decision written down; `Guards.matrix` prints it `closed` or `open`.\n */\n readonly unguarded: 'allow' | 'deny'\n },\n ): GuardSet<Name, Schema.Struct.Type<Fields>, S> => {\n type User = Schema.Struct.Type<Fields>\n // The type requires it; a caller without types (or one that spelled it\n // `'Allow'`) would otherwise get a set that denies, silently.\n if (options.unguarded !== 'allow' && options.unguarded !== 'deny')\n throw new Error(\n `[foldkit-guard] ${name}: unguarded must be 'allow' or 'deny', not ${JSON.stringify(options.unguarded)}`,\n )\n const placeholders = placeholdersOf<User>(principal.fields)\n const specs = build({\n principal: () => Object.freeze({ _tag: 'PrincipalSpec' }),\n row: (entity, body) => Object.freeze({ _tag: 'RowSpec', entity, body: body(placeholders) }),\n })\n const guards: Record<string, AnyGuard<User>> = Object.create(null)\n for (const [guard, spec] of Object.entries(specs)) {\n if ((reserved as ReadonlyArray<string>).includes(guard)) {\n throw new Error(\n `[foldkit-guard] ${name}: \"${guard}\" is a name the guard set keeps for itself`,\n )\n }\n guards[guard] = Match.valueTags(spec, {\n PrincipalSpec: (): AnyGuard<User> =>\n Object.freeze({ _tag: 'PrincipalGuard', name: guard, set: name }),\n RowSpec: ({ entity, body }): AnyGuard<User> =>\n Object.freeze({\n _tag: 'RowGuard',\n name: guard,\n set: name,\n entity,\n body,\n // Checks the body reads only this Entity's fields, where it is declared.\n query: Query.from(entity).pipe(Query.where(body)),\n }),\n })\n }\n const principalNames = Object.keys(guards).filter(\n guard => guards[guard]!._tag === 'PrincipalGuard',\n )\n const encoders = Object.fromEntries(\n Object.entries(principal.fields).map(([field, schema]) => [\n field,\n Schema.encodeSync(schema as unknown as Schema.Codec<unknown, unknown>),\n ]),\n )\n const inputOf = (user: User): Readonly<Record<string, unknown>> => {\n const input: Record<string, unknown> = {}\n for (const [field, encode] of Object.entries(encoders)) {\n input[`principal.${field}`] = encode((user as Record<string, unknown>)[field])\n }\n return input\n }\n\n const isPrincipal = Schema.is(Schema.Option(principal))\n // Every claim as JSON keeps it, a set, a number past JSON's or a date\n // included: two principals that differ in one never share a key.\n const asJson = Schema.encodeSync(\n Schema.toCodecJson(principal) as unknown as Schema.Codec<unknown, unknown>,\n )\n\n const implement = <R>(bodies: Readonly<Record<string, Body<User, R>>>): Policy<User, R> => {\n const missing = principalNames.filter(guard => !Object.hasOwn(bodies, guard))\n const extra = Object.keys(bodies).filter(guard => !principalNames.includes(guard))\n if (missing.length > 0 || extra.length > 0) {\n throw new Error(\n `[foldkit-guard] ${name}.implement: ${[\n missing.length > 0 ? `no body for ${missing.join(', ')}` : '',\n extra.length > 0 ? `${extra.join(', ')} is not a principal guard` : '',\n ]\n .filter(part => part !== '')\n .join('; ')}`,\n )\n }\n const decide: Policy<User, R>['decide'] = (guard, { principal, interaction, row }) => {\n if (guard.set !== name) {\n return Effect.die(\n new Error(`[foldkit-guard] ${name}: \"${guard.name}\" belongs to ${guard.set}`),\n )\n }\n return Match.valueTags(guard, {\n PrincipalGuard: ({ name: body }) => {\n const decided = bodies[body]!(principal, { interaction })\n return Effect.isEffect(decided) ? decided : Effect.succeed(decided)\n },\n RowGuard: rowGuard =>\n Effect.succeed(\n row !== undefined &&\n Option.match(principal, {\n // A visitor has no fields: only a guard over the row alone can hold.\n onNone: () =>\n !readsPrincipal(rowGuard) && evaluate(rowGuard.query, {}, [row]).length === 1,\n onSome: user => evaluate(rowGuard.query, inputOf(user), [row]).length === 1,\n }),\n ),\n })\n }\n const decidingFor = (\n entity: AnyEntity,\n principal: Option.Option<User>,\n interaction: string,\n ) => {\n Option.map(attached(entity), ({ set }) => {\n if (set !== name) {\n throw new Error(`[foldkit-guard] ${name}: ${entity.name} carries the guards of ${set}`)\n }\n })\n return deciding(\n guard =>\n Effect.map(decide(guard, { principal, interaction }), decision => decision === true),\n Option.isNone(principal),\n interaction,\n )\n }\n const policy: Policy<User, R> = {\n set: name,\n decide,\n readable: (entity, principal) =>\n Effect.map(\n decidingFor(entity, principal, 'Read').row(entity),\n ({ condition }) => condition,\n ),\n readMembers: (entity, principal, members) =>\n decidingFor(entity, principal, 'Read').members(entity, members),\n writable: (entity, principal, interaction) =>\n decidingFor(entity, principal, interaction).row(entity),\n writeMembers: (entity, principal, members, interaction) =>\n decidingFor(entity, principal, interaction).members(entity, members),\n linkable: (entity, principal, relation, interaction) =>\n decidingFor(entity, principal, interaction).relation(entity, relation),\n inputOf: principal =>\n Option.match(principal, { onNone: () => ({}), onSome: user => inputOf(user) }),\n key: options.key,\n // Prefixed, so no user's key is the visitor's. Not `declare`'s `key`\n // alone: a re-read shared under it would read a newer request as an\n // older one's claims.\n keyOf: principal =>\n Option.match(principal, {\n onNone: () => 'visitor',\n onSome: user => `user:${JSON.stringify(asJson(user))}`,\n }),\n isPrincipal,\n provide: context => provided(policy, context),\n }\n return policy\n }\n\n return Object.freeze({\n ...guards,\n name,\n schema: principal as unknown as Schema.Codec<User, unknown>,\n Principal: Context.Service<PrincipalOf<Name>, Option.Option<User>>(\n `foldkit-guard/Principal/${name}`,\n ),\n key: options.key,\n unguarded: options.unguarded,\n inputOf,\n implement,\n }) as unknown as GuardSet<Name, User, S>\n },\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { t as Attaching } from "./attach-BZyVvs7H.mjs";
|
|
2
|
+
import { t as May } from "./may-DK-2lomO.mjs";
|
|
3
|
+
import { Schema } from "effect";
|
|
4
|
+
import { Entity } from "foldkit-entity";
|
|
5
|
+
//#region src/me.ts
|
|
6
|
+
/**
|
|
7
|
+
* The visitor as an Entity: one row, `me`, answered for whoever asks. What a
|
|
8
|
+
* client knows about itself (signed in, as whom, what it may open) is read
|
|
9
|
+
* through Remote like any row, `may` included, so no rule runs on the client.
|
|
10
|
+
*/
|
|
11
|
+
/** The one row's id. */
|
|
12
|
+
const ME = "me";
|
|
13
|
+
const MeFields = Entity.define("Me", Schema.Struct({
|
|
14
|
+
id: Schema.String,
|
|
15
|
+
/** Whether the server answered as someone. */
|
|
16
|
+
signedIn: Schema.Boolean,
|
|
17
|
+
/** Who the server answered as: `declare`'s `key` of the principal. */
|
|
18
|
+
key: Schema.OptionFromNullOr(Schema.String)
|
|
19
|
+
}));
|
|
20
|
+
/**
|
|
21
|
+
* `Me` for guard set `G`: everyone reads their own row, no one writes it, and
|
|
22
|
+
* each interaction is answered in `may` as `G`'s bodies decide it for the
|
|
23
|
+
* asker (`May.can(me.may, OpenAdmin.key)`).
|
|
24
|
+
*
|
|
25
|
+
* ```ts
|
|
26
|
+
* const OpenAdmin = Interaction.make('OpenAdmin')
|
|
27
|
+
* export const Me = Guards.me(G, { interactions: { [OpenAdmin.key]: [G.isAdmin] } })
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
const me = (G, options = {}) => MeFields.pipe(Attaching.attach(G, {
|
|
31
|
+
row: {
|
|
32
|
+
Read: [Attaching.anyone],
|
|
33
|
+
Write: []
|
|
34
|
+
},
|
|
35
|
+
...options.interactions === void 0 ? {} : { interactions: options.interactions }
|
|
36
|
+
}), May.member);
|
|
37
|
+
//#endregion
|
|
38
|
+
export { me as n, ME as t };
|
|
39
|
+
|
|
40
|
+
//# sourceMappingURL=me-DeSZOGt3.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"me-DeSZOGt3.mjs","names":[],"sources":["../src/me.ts"],"sourcesContent":["/**\n * The visitor as an Entity: one row, `me`, answered for whoever asks. What a\n * client knows about itself (signed in, as whom, what it may open) is read\n * through Remote like any row, `may` included, so no rule runs on the client.\n */\nimport { Schema } from 'effect'\nimport { Entity } from 'foldkit-entity'\nimport { Attaching, type Attach } from './attach.js'\nimport { May } from './may.js'\n\n/** The one row's id. */\nexport const ME = 'me'\n\nconst MeFields = Entity.define(\n 'Me',\n Schema.Struct({\n id: Schema.String,\n /** Whether the server answered as someone. */\n signedIn: Schema.Boolean,\n /** Who the server answered as: `declare`'s `key` of the principal. */\n key: Schema.OptionFromNullOr(Schema.String),\n }),\n)\n\n/** `Me`'s Entity, with `may`. */\nexport type MeEntity = ReturnType<typeof May.member<typeof MeFields>>\n\n/**\n * `Me` for guard set `G`: everyone reads their own row, no one writes it, and\n * each interaction is answered in `may` as `G`'s bodies decide it for the\n * asker (`May.can(me.may, OpenAdmin.key)`).\n *\n * ```ts\n * const OpenAdmin = Interaction.make('OpenAdmin')\n * export const Me = Guards.me(G, { interactions: { [OpenAdmin.key]: [G.isAdmin] } })\n * ```\n */\nexport const me = <Name extends string, User>(\n G: {\n readonly name: Name\n readonly schema: Schema.Codec<User, unknown>\n readonly unguarded: 'allow' | 'deny'\n },\n options: {\n readonly interactions?: Attach<NoInfer<User>, NoInfer<Name>, typeof MeFields>['interactions']\n } = {},\n): MeEntity =>\n MeFields.pipe(\n Attaching.attach(G, {\n row: { Read: [Attaching.anyone], Write: [] },\n ...(options.interactions === undefined ? {} : { interactions: options.interactions }),\n }),\n May.member,\n )\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,KAAK;AAElB,MAAM,WAAW,OAAO,OACtB,MACA,OAAO,OAAO;CACZ,IAAI,OAAO;;CAEX,UAAU,OAAO;;CAEjB,KAAK,OAAO,iBAAiB,OAAO,MAAM;AAC5C,CAAC,CACH;;;;;;;;;;;AAeA,MAAa,MACX,GAKA,UAEI,CAAC,MAEL,SAAS,KACP,UAAU,OAAO,GAAG;CAClB,KAAK;EAAE,MAAM,CAAC,UAAU,MAAM;EAAG,OAAO,CAAC;CAAE;CAC3C,GAAI,QAAQ,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;AACrF,CAAC,GACD,IAAI,MACN"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
//#region src/origin.ts
|
|
2
|
+
const origins = /* @__PURE__ */ new WeakMap();
|
|
3
|
+
/** The Policy `G.implement` built that `policy` was provided from: itself, for one it built. */
|
|
4
|
+
const originOf = (policy) => origins.get(policy) ?? policy;
|
|
5
|
+
/** Records `policy` as provided from `from`. */
|
|
6
|
+
const providedFrom = (policy, from) => {
|
|
7
|
+
origins.set(policy, originOf(from));
|
|
8
|
+
return policy;
|
|
9
|
+
};
|
|
10
|
+
//#endregion
|
|
11
|
+
export { providedFrom as n, originOf as t };
|
|
12
|
+
|
|
13
|
+
//# sourceMappingURL=origin-CN6ThFTp.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"origin-CN6ThFTp.mjs","names":[],"sources":["../src/origin.ts"],"sourcesContent":["/**\n * Which Policy another was provided from, so a seam built from one counts as\n * built from the other: `Policy.provide` keeps the bodies and rules, and\n * changes only the services they run with. `validate` checks that a seam's\n * rules are the declared ones; it does not check which services they were\n * given.\n */\nimport type { Policy } from './index.js'\n\nconst origins = new WeakMap<object, object>()\n\n/** The Policy `G.implement` built that `policy` was provided from: itself, for one it built. */\nexport const originOf = (policy: Policy<any, any>): object => origins.get(policy) ?? policy\n\n/** Records `policy` as provided from `from`. */\nexport const providedFrom = <P extends Policy<any, any>>(policy: P, from: Policy<any, any>): P => {\n origins.set(policy, originOf(from))\n return policy\n}\n"],"mappings":";AASA,MAAM,0BAAU,IAAI,QAAwB;;AAG5C,MAAa,YAAY,WAAqC,QAAQ,IAAI,MAAM,KAAK;;AAGrF,MAAa,gBAA4C,QAAW,SAA8B;CAChG,QAAQ,IAAI,QAAQ,SAAS,IAAI,CAAC;CAClC,OAAO;AACT"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { r as attached } from "./attach-
|
|
1
|
+
import { r as attached } from "./attach-BZyVvs7H.mjs";
|
|
2
|
+
import { t as originOf } from "./origin-CN6ThFTp.mjs";
|
|
2
3
|
import { Option } from "effect";
|
|
3
4
|
//#region src/placed.ts
|
|
4
5
|
/**
|
|
@@ -24,7 +25,7 @@ const record = (registry) => ({
|
|
|
24
25
|
has: (built, policy, entity) => {
|
|
25
26
|
if (typeof built !== "function" && (typeof built !== "object" || built === null)) return false;
|
|
26
27
|
const placed = registry.get(built);
|
|
27
|
-
return placed !== void 0 && placed.policy === policy && placed.entities.has(entity.name) && placed.entities.get(entity.name) === guardsOf(entity);
|
|
28
|
+
return placed !== void 0 && originOf(placed.policy) === originOf(policy) && placed.entities.has(entity.name) && placed.entities.get(entity.name) === guardsOf(entity);
|
|
28
29
|
}
|
|
29
30
|
});
|
|
30
31
|
/** Row rules: `GuardDrizzle.visible`'s, and `GuardServer.memory`'s `readable`. */
|
|
@@ -36,4 +37,4 @@ const writeRules = record(/* @__PURE__ */ new WeakMap());
|
|
|
36
37
|
//#endregion
|
|
37
38
|
export { rowRules as n, writeRules as r, memberRules as t };
|
|
38
39
|
|
|
39
|
-
//# sourceMappingURL=placed-
|
|
40
|
+
//# sourceMappingURL=placed-CkyMqxFw.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"placed-CkyMqxFw.mjs","names":[],"sources":["../src/placed.ts"],"sourcesContent":["/**\n * What each guard seam built, and for which Policy and Entities, so\n * `GuardServer.validate` can tell a Source that applies a guard set's rules\n * from one that only looks as if it does.\n */\nimport { Option } from 'effect'\nimport type { AnyEntity } from 'foldkit-entity'\nimport { attached, type Attachment } from './attach.js'\nimport type { Policy } from './index.js'\nimport { originOf } from './origin.js'\n\ninterface Placed {\n readonly policy: Policy<any, any>\n /** Each Entity's attachment as it was built from: none for one built before `attach`. */\n readonly entities: ReadonlyMap<string, Attachment | undefined>\n}\n\n/** An Entity's guards, by identity: the same attachment is the same rules. */\nconst guardsOf = (entity: AnyEntity) => Option.getOrUndefined(attached(entity))\n\nconst record = (registry: WeakMap<object, Placed>) => ({\n add: <F extends object>(built: F, policy: Policy<any, any>, entities: Iterable<AnyEntity>): F => {\n registry.set(built, {\n policy,\n entities: new Map([...entities].map(entity => [entity.name, guardsOf(entity)])),\n })\n return built\n },\n /**\n * Whether `built` applies `entity`'s guards from `policy`: built for it,\n * not for another Entity of its name, nor for it before its guards were\n * attached, which decides nothing.\n */\n has: (built: unknown, policy: Policy<any, any>, entity: AnyEntity): boolean => {\n if (typeof built !== 'function' && (typeof built !== 'object' || built === null)) return false\n const placed = registry.get(built)\n return (\n placed !== undefined &&\n originOf(placed.policy) === originOf(policy) &&\n placed.entities.has(entity.name) &&\n placed.entities.get(entity.name) === guardsOf(entity)\n )\n },\n})\n\n/** Row rules: `GuardDrizzle.visible`'s, and `GuardServer.memory`'s `readable`. */\nexport const rowRules = record(new WeakMap())\n\n/** Member and relation rules: `GuardServer.filter`'s. */\nexport const memberRules = record(new WeakMap())\n\n/** Write rules: `GuardServer.writer`'s. */\nexport const writeRules = record(new WeakMap())\n"],"mappings":";;;;;;;;;;AAkBA,MAAM,YAAY,WAAsB,OAAO,eAAe,SAAS,MAAM,CAAC;AAE9E,MAAM,UAAU,cAAuC;CACrD,MAAwB,OAAU,QAA0B,aAAqC;EAC/F,SAAS,IAAI,OAAO;GAClB;GACA,UAAU,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,KAAI,WAAU,CAAC,OAAO,MAAM,SAAS,MAAM,CAAC,CAAC,CAAC;EAChF,CAAC;EACD,OAAO;CACT;;;;;;CAMA,MAAM,OAAgB,QAA0B,WAA+B;EAC7E,IAAI,OAAO,UAAU,eAAe,OAAO,UAAU,YAAY,UAAU,OAAO,OAAO;EACzF,MAAM,SAAS,SAAS,IAAI,KAAK;EACjC,OACE,WAAW,KAAA,KACX,SAAS,OAAO,MAAM,MAAM,SAAS,MAAM,KAC3C,OAAO,SAAS,IAAI,OAAO,IAAI,KAC/B,OAAO,SAAS,IAAI,OAAO,IAAI,MAAM,SAAS,MAAM;CAExD;AACF;;AAGA,MAAa,WAAW,uBAAO,IAAI,QAAQ,CAAC;;AAG5C,MAAa,cAAc,uBAAO,IAAI,QAAQ,CAAC;;AAG/C,MAAa,aAAa,uBAAO,IAAI,QAAQ,CAAC"}
|
package/dist/server.d.mts
CHANGED
|
@@ -1,10 +1,20 @@
|
|
|
1
|
-
import { S as Policy, l as InteractionKey } from "./attach-
|
|
1
|
+
import { S as Policy, k as MeEntity, l as InteractionKey } from "./attach-BVG6LsFf.mjs";
|
|
2
2
|
import { Effect, Option } from "effect";
|
|
3
3
|
import { AnyEntity, AnyQuery } from "foldkit-entity";
|
|
4
4
|
import { EntitySource, EntityWriter, MemoryReadable, MutationOutcome, MutationRefused, MutationSource, ReadPlan, RemoteServerError, ServerDefinition } from "foldkit-remote-server";
|
|
5
5
|
import { MutationDescriptor, RemoteForbidden } from "foldkit-remote";
|
|
6
6
|
//#region src/server.d.ts
|
|
7
7
|
export declare const GuardServer: {
|
|
8
|
+
/**
|
|
9
|
+
* `Guards.me`'s Source: the one row, `me`, as the asker is, with `may`
|
|
10
|
+
* answered by `policy`. `signedIn` is whether the server answered as
|
|
11
|
+
* someone; `key` is their `key`. Any other id is no row.
|
|
12
|
+
*
|
|
13
|
+
* ```ts
|
|
14
|
+
* RemoteServer.make({ entities: [GuardServer.me(Me, Policy), …] })
|
|
15
|
+
* ```
|
|
16
|
+
*/
|
|
17
|
+
me: <User, R>(entity: MeEntity, policy: Policy<User, R>) => EntitySource<Option.Option<User>, R>;
|
|
8
18
|
/**
|
|
9
19
|
* An `EntitySource.filter` for `entity`: each requested member with a Read
|
|
10
20
|
* rule is decided per record, omitted or redacted where the rule refuses.
|
package/dist/server.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server.ts"],"mappings":";;;;;;
|
|
1
|
+
{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server.ts"],"mappings":";;;;;;qBAyCa;;;;;;;;;;EAUX,KAAK,MAAM,GAAC,QACF,UAAQ,QACR,OAAO,MAAM,OACpB,aAAa,OAAO,OAAO,OAAO;;;;;;;;;;EA6CrC,SAAS,MAAM,GAAC,QAAU,WAAS,QAAU,OAAO,MAAM,QAAE,WAG3C,OAAO,OAAO,OAAK,8BAE7B,OAAO,OAAO,iBAAiB;;;;;;;EAoEtC,SAAS,MAAI,QAAU,OAAO,OAAK,UAAY,cAAc;IAC3D,WAAQ,WAEO,OAAO,OAAO,OAAK,MACxB,gBAAgB,eAAe,OAAO,OAAO,SAAS,8BAC3D,OAAO,OAAO;IAuCnB;OAjHY,aAAA,WAAA,OAAA,OAAA,OAAA,8BAAiB,OAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;EA6I/B,SAAS,UAAU,WAAW,MAAM,GAAG,IAAE,QAC/B,GAAC,QACD,OAAO,MAAM,IAAE,QACf,aAAa,OAAO,OAAO,OAAO,KAAG;aAElC,sBACG,WAAW,gBAAgB,MAAM,SAAS,YAAY;QAGnE,aAAa,OAAO,OAAO,OAAO,IAAI;;;;;;;;;;;;;;;;;;;;;EA8OzC,WAAW,MAAM,GAAG,IAAI,IAAI,qBAAqB,OAAO,QAAQ,SAAO,UAC3D,mBAAmB,MAAM,OAAO,QAAQ,UAAQ;aAE/C,QAAQ;aACR,QAAQ,OAAO,MAAM;aACrB,8CAA8C;;;;;;aAM9C,OAAO,OAAO,mBAAmB,OAAO;;aAExC,QAAQ,aAAa,OAAO,OAAO,OAAO;;aAE1C,SAAS;KACnB,MACK;aACK,OAAO;aACP,WAAW,OAAO,OAAO;aACzB;aACA,KAAK,OAAO,OAAO,SAAS;QACjC,OAAO,OACX,gBAAgB,SAChB,oBAAoB,kBAAkB,iBACtC,QAED,eAAe,OAAO,OAAO,OAAO,IAAI,KAAK;;;;;;;;;;;;;;;;;;EA6FhD,WAAW,MAAM,GAAC,QACR,OAAO,MAAM,IAAE;aAEZ,UAAU,cAAc;;aAExB;eACE;iBACE,SAAS;mBAEL;mBAA0B,OAAO;;;;aAIzC,QAAQ"}
|
package/dist/server.mjs
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { t as Condition } from "./condition-
|
|
3
|
-
import
|
|
1
|
+
import { o as readRowsRuled, r as attached, s as readRuled } from "./attach-BZyVvs7H.mjs";
|
|
2
|
+
import { t as Condition } from "./condition-Dunujvzy.mjs";
|
|
3
|
+
import "./me-DeSZOGt3.mjs";
|
|
4
|
+
import { n as rowRules, r as writeRules, t as memberRules } from "./placed-CkyMqxFw.mjs";
|
|
4
5
|
import { Effect, Match, Option, Schema } from "effect";
|
|
5
6
|
import { Query } from "foldkit-entity";
|
|
6
7
|
import { RemoteServer, RemoteServerError } from "foldkit-remote-server";
|
|
@@ -23,6 +24,36 @@ const refOf = (value) => {
|
|
|
23
24
|
});
|
|
24
25
|
};
|
|
25
26
|
const GuardServer = {
|
|
27
|
+
/**
|
|
28
|
+
* `Guards.me`'s Source: the one row, `me`, as the asker is, with `may`
|
|
29
|
+
* answered by `policy`. `signedIn` is whether the server answered as
|
|
30
|
+
* someone; `key` is their `key`. Any other id is no row.
|
|
31
|
+
*
|
|
32
|
+
* ```ts
|
|
33
|
+
* RemoteServer.make({ entities: [GuardServer.me(Me, Policy), …] })
|
|
34
|
+
* ```
|
|
35
|
+
*/
|
|
36
|
+
me: (entity, policy) => {
|
|
37
|
+
Option.map(attached(entity), ({ set }) => {
|
|
38
|
+
if (set !== policy.set) throw new Error(`[foldkit-guard] GuardServer.me: Me carries the guards of ${set}, not ${policy.set}`);
|
|
39
|
+
});
|
|
40
|
+
return {
|
|
41
|
+
...RemoteServer.entity(entity, {
|
|
42
|
+
read: ({ ids, principal }) => Effect.succeed(ids.filter((id) => id === "me").map((id) => ({
|
|
43
|
+
id,
|
|
44
|
+
values: {
|
|
45
|
+
signedIn: Option.isSome(principal),
|
|
46
|
+
key: Option.match(principal, {
|
|
47
|
+
onNone: () => null,
|
|
48
|
+
onSome: policy.key
|
|
49
|
+
})
|
|
50
|
+
}
|
|
51
|
+
}))),
|
|
52
|
+
filter: GuardServer.filter(entity, policy)
|
|
53
|
+
}),
|
|
54
|
+
visible: rowRules.add(Object.freeze({ reads: "the asker’s own row" }), policy, [entity])
|
|
55
|
+
};
|
|
56
|
+
},
|
|
26
57
|
/**
|
|
27
58
|
* An `EntitySource.filter` for `entity`: each requested member with a Read
|
|
28
59
|
* rule is decided per record, omitted or redacted where the rule refuses.
|
package/dist/server.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["/**\n * A guard set's read rules as `foldkit-remote-server`'s seams: an\n * `EntitySource.filter` from each member's Read rule, and `RemoteServer.memory`'s\n * `readable` and `filter` from the row's, and a check at startup that a server\n * applies them. A subpath, so the shared declaration the browser imports never\n * brings the server along.\n */\nimport { Effect, Match, Option, Schema } from 'effect'\nimport { Query, type AnyEntity, type AnyQuery } from 'foldkit-entity'\nimport type { MutationDescriptor, RemoteForbidden } from 'foldkit-remote'\nimport {\n RemoteServer,\n RemoteServerError,\n type EntityRecord,\n type EntitySource,\n type EntityWriter,\n type MutationOutcome,\n type MutationRefused,\n type MutationSource,\n type MemoryReadable,\n type ReadPlan,\n type ServerDefinition,\n} from 'foldkit-remote-server'\nimport { attached, readRowsRuled, readRuled, type Deny, type InteractionKey } from './attach.js'\nimport { Condition, type RowRule } from './condition.js'\nimport type { Policy } from './index.js'\nimport type { MayAnswer } from './may.js'\nimport { memberRules, rowRules, writeRules } from './placed.js'\n\nconst noMembers = (record: EntityRecord) => record\n\n/** A ref key's two halves, `Entity:id`; `none` for anything else. */\nconst refOf = (value: unknown): Option.Option<{ readonly entity: string; readonly id: string }> => {\n if (typeof value !== 'string') return Option.none()\n const split = value.indexOf(':')\n return split <= 0\n ? Option.none()\n : Option.some({ entity: value.slice(0, split), id: value.slice(split + 1) })\n}\n\nexport const GuardServer = {\n /**\n * An `EntitySource.filter` for `entity`: each requested member with a Read\n * rule is decided per record, omitted or redacted where the rule refuses.\n * The fields a rule reads are read too, so it can be decided.\n *\n * ```ts\n * RemoteServer.entity(Todo, { read, filter: GuardServer.filter(Todo, Policy) })\n * ```\n */\n filter: <User, R>(entity: AnyEntity, policy: Policy<User, R>) =>\n memberRules.add(\n (\n principal: Option.Option<User>,\n fields: readonly string[],\n ): Effect.Effect<ReadPlan, never, R> =>\n Effect.map(\n Effect.all([\n policy.readMembers(entity, principal, fields),\n // `may` is answered here, where the row is read as its principal sees it.\n asksMay(entity, fields)\n ? Effect.map(mayOf(entity, policy, principal), Option.some)\n : Effect.succeed(Option.none<MayPlan>()),\n ]),\n ([members, may]): ReadPlan => {\n if (members.length === 0 && Option.isNone(may)) return { fields, apply: noMembers }\n const input = policy.inputOf(principal)\n const decided = members.map(member => ({\n ...member,\n // A redacted value is a decoded one; the record holds what the store holds.\n redacted:\n member.deny._tag === 'Redact'\n ? Option.some(\n Schema.encodeSync(\n (\n entity.members as Readonly<\n Record<string, { readonly schema: Schema.Top }>\n >\n )[member.member]!.schema as unknown as Schema.Codec<unknown, unknown>,\n )(member.deny.value),\n )\n : Option.none(),\n }))\n return {\n fields: [\n ...new Set([\n ...fields,\n ...members.flatMap(({ condition }) => Condition.members(condition)),\n ...Option.match(may, { onNone: () => [], onSome: ({ fields }) => fields }),\n ]),\n ],\n apply: record => {\n const values: Record<string, unknown> = { ...record.values }\n for (const { member, condition, redacted } of decided) {\n // Member rules carry no inherited Read: only a row's Read may inherit.\n if (Condition.holds(condition, record.values, input, () => false)) continue\n Option.match(redacted, {\n onNone: () => {\n delete values[member]\n },\n onSome: value => {\n values[member] = value\n },\n })\n }\n Option.map(may, ({ answer }) => {\n values.may = answer(record.values)\n })\n return { id: record.id, values }\n },\n }\n },\n ),\n policy,\n [entity],\n ),\n\n /**\n * `RemoteServer.memory`'s `readable` and `filter` for `entities`, the\n * Entities as `Guards.attach` returned them. A row's Read is decided per\n * stored row, an inherited Read by looking the related row up; an Entity\n * not listed is read by everyone.\n */\n memory: <User>(policy: Policy<User>, entities: ReadonlyArray<AnyEntity>) => ({\n readable: rowRules.add(\n (\n principal: Option.Option<User>,\n row: (entity: string, id: string) => Option.Option<Readonly<Record<string, unknown>>>,\n ): Effect.Effect<MemoryReadable> =>\n Effect.map(\n Effect.forEach(entities, entity =>\n Effect.map(\n policy.readable(entity, principal),\n condition => [entity.name, condition] as const,\n ),\n ),\n (decided): MemoryReadable => {\n const conditions = new Map(decided)\n const input = policy.inputOf(principal)\n // `seen` stops a cycle of inherited Reads, which would otherwise never end.\n const holds = (\n entity: string,\n values: Readonly<Record<string, unknown>>,\n seen: ReadonlySet<string>,\n ): boolean => {\n const condition = conditions.get(entity)\n if (condition === undefined) return true\n return Condition.holds(condition, values, input, relation =>\n Option.match(refOf(values[relation]), {\n onNone: () => false,\n onSome: ref => {\n const key = `${ref.entity}:${ref.id}`\n if (seen.has(key)) return false\n return Option.match(row(ref.entity, ref.id), {\n onNone: () => false,\n onSome: target => holds(ref.entity, target, new Set([...seen, key])),\n })\n },\n }),\n )\n }\n return (entity, values) => holds(entity, values, new Set())\n },\n ),\n policy,\n entities,\n ),\n filter: Object.fromEntries(\n entities.map(entity => [entity.name, GuardServer.filter(entity, policy)] as const),\n ),\n }),\n\n /**\n * `writer` with `entity`'s write rules checked before each write lands, for\n * `RemoteServer.write`. An update or a delete reads the row first under\n * the writer's own `read` (its Source's read rule): a row the writer may not\n * see is refused as one that is not there, and a delete of it changes\n * nothing. Then the row's rule for the command must hold over the row (an\n * update's over the row as it would be after it too, so a write cannot move\n * a row out of its writer's reach), each member it sets must allow setting\n * it, and each relation it points elsewhere must allow the unlink and the\n * link. A create's rules hold over the values it proposes, where a field the\n * create leaves unset matches no guard, not even one for an empty value. A refusal is\n * `Forbidden`, with the sentence an `explain` gave; the write never runs.\n *\n * `presets` are fields a create takes from who is asking, never from the\n * client (`ownerId: user => user.id`): set before the rules are checked, so\n * a rule over them holds of the creator. A visitor has nothing to preset\n * from, and a create whose input sets a preset field is a mistake of the\n * server's, refused.\n *\n * ```ts\n * RemoteServer.write(EditTodo, GuardServer.writer(Todo, Policy, writer(Db.Todo)))\n * ```\n */\n writer: <E extends AnyEntity, User, R, RW>(\n entity: E,\n policy: Policy<User, R>,\n writer: EntityWriter<Option.Option<User>, RW>,\n options: {\n readonly presets?: {\n readonly [K in keyof E['fields']]?: (user: User) => E['fields'][K]['schema']['Type']\n }\n } = {},\n ): EntityWriter<Option.Option<User>, R | RW> => {\n const presets = Object.entries(options.presets ?? {}).map(([field, preset]) => {\n const declared = Object.hasOwn(entity.fields, field)\n ? (entity.fields as Readonly<Record<string, { readonly schema: Schema.Top }>>)[field]\n : undefined\n if (declared === undefined) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name} has no field \"${field}\" to preset`,\n )\n }\n const encode = Schema.encodeUnknownSync(\n declared.schema as unknown as Schema.Codec<unknown, unknown>,\n )\n return { field, value: (user: User) => encode((preset as (user: User) => unknown)(user)) }\n })\n if (writer.entity !== entity.name) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name}'s rules over a writer for ${writer.entity}`,\n )\n }\n const read = writer.read\n if (read === undefined) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name}'s writer reads no row as its writer may see it; bind it with a visible rule (GuardDrizzle.visible)`,\n )\n }\n const holds = (\n rule: { readonly condition: Condition },\n values: Readonly<Record<string, unknown>>,\n principal: Option.Option<User>,\n ) => Condition.holds(rule.condition, values, policy.inputOf(principal), () => false)\n /** Fails with the first rule of `rules` that does not hold over `values`. */\n const require = (\n rules: ReadonlyArray<{ readonly condition: Condition; readonly deny: Deny }>,\n values: Readonly<Record<string, unknown>>,\n principal: Option.Option<User>,\n ) =>\n Option.match(Option.fromUndefinedOr(rules.find(rule => !holds(rule, values, principal))), {\n onNone: () => Effect.void,\n onSome: rule => Effect.fail(refused(rule.deny)),\n })\n type Links = Readonly<\n Record<string, Option.Option<{ readonly entity: string; readonly id: string }>>\n >\n /** Each relation `links` points: its rules for unlinking and for linking a row. */\n const linkRules = (principal: Option.Option<User>, links: Links) =>\n Effect.forEach(Object.entries(links), ([relation, target]) =>\n Effect.map(\n Effect.all([\n policy.linkable(entity, principal, relation, 'Unlink'),\n policy.linkable(entity, principal, relation, 'Link'),\n ]),\n ([unlink, link]) => ({ relation, now: linkKey(target), unlink, link }),\n ),\n )\n /**\n * The rules a change from what each relation was linked to, to what it now\n * points at, must meet; none `before` is a create, which unlinks nothing.\n * Where `exact` is false, `links` are the row as its writer sees it, where\n * a link to a row hidden from them reads as none: a relation seen unlinked\n * may be linked after all, so changing it unlinks too.\n */\n const linking = (\n rules: ReadonlyArray<{\n readonly relation: string\n readonly now: string | null\n readonly unlink: Option.Option<RowRule>\n readonly link: Option.Option<RowRule>\n }>,\n before: Option.Option<{\n readonly links: Readonly<Record<string, unknown>>\n readonly exact: boolean\n }>,\n ): ReadonlyArray<RowRule> =>\n rules.flatMap(({ relation, now, unlink, link }) =>\n Option.match(before, {\n onNone: () => (now === null ? [] : Option.toArray(link)),\n onSome: ({ links, exact }) => {\n const was = links[relation] ?? null\n if (was === now && (exact || was !== null)) return []\n return [\n ...(was === null && exact ? [] : Option.toArray(unlink)),\n ...(now === null ? [] : Option.toArray(link)),\n ]\n },\n }),\n )\n const ruleOf = (\n rules: ReadonlyArray<{\n readonly unlink: Option.Option<RowRule>\n readonly link: Option.Option<RowRule>\n }>,\n ) => rules.flatMap(({ unlink, link }) => [...Option.toArray(unlink), ...Option.toArray(link)])\n const fieldsOf = (\n rules: ReadonlyArray<{ readonly condition: Condition }>,\n more: Iterable<string>,\n ) => [\n ...new Set([\n 'id',\n ...more,\n ...rules.flatMap(({ condition }) => Condition.members(condition)),\n ]),\n ]\n // What an answer shows: the row as the writer may see it, members ruled.\n const memberRead = GuardServer.filter(entity, policy)\n const guarded: EntityWriter<Option.Option<User>, R | RW> = {\n entity: writer.entity,\n read: ({ id, fields, principal }) =>\n seenRow(\n { filter: memberRead },\n seen => read({ id, fields: seen, principal }),\n principal,\n fields,\n id,\n ),\n update: context =>\n Effect.gen(function* () {\n const { principal, values, links } = context\n const row = yield* policy.writable(entity, principal, 'Update')\n const members = yield* policy.writeMembers(\n entity,\n principal,\n Object.keys(values),\n 'Update',\n )\n const relating = yield* linkRules(principal, links)\n const fields = fieldsOf([row, ...members, ...ruleOf(relating)], Object.keys(links))\n const current = yield* read({ id: context.id, fields, principal })\n if (Option.isNone(current)) return yield* Effect.fail(refused(row.deny))\n const before = current.value\n const linked = Object.keys(links)\n const stored =\n writer.linked === undefined || linked.length === 0\n ? Option.none()\n : yield* writer.linked({ id: context.id, relations: linked })\n const relations = linking(\n relating,\n Option.some(\n Option.match(stored, {\n onNone: () => ({ links: before, exact: false }),\n onSome: links => ({ links, exact: true }),\n }),\n ),\n )\n const after = {\n ...before,\n ...values,\n ...Object.fromEntries(\n Object.entries(links).map(([relation, link]) => [relation, linkKey(link)]),\n ),\n }\n yield* require([row, ...members, ...relations], before, principal)\n yield* require([row], after, principal)\n return yield* writer.update(context)\n }),\n insert: given =>\n Effect.gen(function* () {\n const preset = presets.find(({ field }) => Object.hasOwn(given.values, field))\n if (preset !== undefined) {\n return yield* new RemoteServerError({\n message: `${entity.name}'s \"${preset.field}\" is preset by the server; the input may not set it`,\n })\n }\n if (presets.length > 0 && Option.isNone(given.principal)) {\n return yield* Effect.fail(RemoteServer.forbid())\n }\n const context = Option.match(given.principal, {\n onNone: () => given,\n onSome: user => ({\n ...given,\n values: {\n ...given.values,\n ...Object.fromEntries(presets.map(({ field, value }) => [field, value(user)])),\n },\n }),\n })\n const { principal, values, links } = context\n const row = yield* policy.writable(entity, principal, 'Create')\n const members = yield* policy.writeMembers(\n entity,\n principal,\n Object.keys(values),\n 'Create',\n )\n const relations = linking(yield* linkRules(principal, links), Option.none())\n const proposed = {\n ...values,\n id: context.id,\n ...Object.fromEntries(\n Object.entries(links).map(([relation, link]) => [relation, linkKey(link)]),\n ),\n }\n const rules = [row, ...members, ...relations]\n const ruled = rules.flatMap(({ condition }) => Condition.members(condition))\n const unset = new Set(ruled.filter(field => !Object.hasOwn(proposed, field)))\n yield* require(rules.map(rule => ({\n ...rule,\n condition: Condition.unsetting(rule.condition, unset),\n })), proposed, principal)\n return yield* writer.insert(context)\n }),\n delete: context =>\n Effect.gen(function* () {\n const row = yield* policy.writable(entity, context.principal, 'Delete')\n const current = yield* read({\n id: context.id,\n fields: fieldsOf([row], []),\n principal: context.principal,\n })\n // Hidden or gone, the writer sees no row: there is nothing of theirs to delete.\n if (Option.isNone(current)) return 'absent' as const\n yield* require([row], current.value, context.principal)\n return yield* writer.delete(context)\n }),\n }\n return writeRules.add(guarded, policy, [entity])\n },\n\n /**\n * A handler's Source (`RemoteServer.mutation`'s) with `entity`'s rule for\n * `interaction` checked before it runs. The row the input names (`id`) is\n * read through `source`, which must apply the Entity's Read rules, and the\n * rule must hold over it; a row its writer may not see is refused. With no\n * `id` (a create), the rule must hold of who is asking alone, a field it\n * reads matching no guard. `run` is given the row as read: its fields the\n * rule reads, its `id`, and `fields`. A refusal is `Forbidden`; `run` never\n * runs. What `run` writes is its own: check members it sets there. Each\n * row of `entity` its answer carries is read back through `source`, so the\n * answer shows its writer only what they may see, a row it hid from them\n * as deleted.\n *\n * ```ts\n * GuardServer.mutation(ArchiveTodo, {\n * entity: Todo, policy: Policy, interaction: Archive.key,\n * id: input => input.id, source: source(Db.Todo),\n * }, ({ input, row }) => …)\n * ```\n */\n mutation: <User, R, RS, RM, Name extends string, Input, Output, Refused>(\n mutation: MutationDescriptor<Name, Input, Output, Refused>,\n guard: {\n readonly entity: AnyEntity\n readonly policy: Policy<User, R>\n readonly interaction: 'Create' | 'Update' | 'Delete' | InteractionKey\n /**\n * The row the input acts on; none for a create. An input whose id may be\n * absent (`Option`, as one editor's for create and edit) creates when it\n * is, checked against `Create`.\n */\n readonly id?: ((input: Input) => string | Option.Option<string>) | undefined\n /** Reads the row as its writer may see it: the Entity's guarded Source. */\n readonly source: EntitySource<Option.Option<User>, RS>\n /** More of the row for `run`, beside what the rule reads. */\n readonly fields?: ReadonlyArray<string> | undefined\n },\n run: (context: {\n readonly input: Input\n readonly principal: Option.Option<User>\n readonly requestId: string\n readonly row: Option.Option<Readonly<Record<string, unknown>>>\n }) => Effect.Effect<\n MutationOutcome<Output>,\n RemoteServerError | MutationRefused | RemoteForbidden,\n RM\n >,\n ): MutationSource<Option.Option<User>, R | RS | RM> => {\n const { entity, policy, interaction, id, source } = guard\n if (!rowRules.has(source.visible, policy, entity)) {\n throw new Error(\n `[foldkit-guard] GuardServer.mutation: ${mutation.name}'s Source does not apply ${entity.name}'s Read rules`,\n )\n }\n /**\n * The answer as its writer may now see it: each row of `entity` it carries\n * read back through `source`, and one the handler hid from them deleted.\n */\n const shown = (outcome: MutationOutcome<Output>, principal: Option.Option<User>) =>\n Effect.map(\n Effect.forEach(outcome.entities ?? [], patch =>\n patch.entity !== entity.name\n ? Effect.succeed(Option.some(patch))\n : Effect.map(\n seenRow(\n source,\n fields =>\n Effect.map(rowOf(source, principal, fields, patch.id), Option.fromUndefinedOr),\n principal,\n Object.keys(patch.values),\n patch.id,\n ),\n Option.map(seen => ({ ...patch, values: seen })),\n ),\n ),\n read => ({\n ...outcome,\n entities: read.flatMap(Option.toArray),\n deleted: [\n ...(outcome.deleted ?? []),\n ...(outcome.entities ?? [])\n .filter((_, index) => Option.isNone(read[index]!))\n .map(({ entity, id }) => ({ entity, id })),\n ],\n }),\n )\n return RemoteServer.mutation<Option.Option<User>, R | RS | RM, Name, Input, Output, Refused>(\n mutation,\n context =>\n Effect.gen(function* () {\n const { principal } = context\n // `context.input` was decoded against the mutation's Input before this runs.\n const target = Option.flatMap(Option.fromUndefinedOr(id), of => {\n const named = of(context.input)\n return typeof named === 'string' ? Option.some(named) : named\n })\n const rule = yield* policy.writable(\n entity,\n principal,\n id !== undefined && Option.isNone(target) ? 'Create' : interaction,\n )\n const ruled = Condition.members(rule.condition)\n const input = policy.inputOf(principal)\n if (Option.isNone(target)) {\n const unset = Condition.unsetting(rule.condition, new Set(ruled))\n if (!Condition.holds(unset, {}, input, () => false)) {\n return yield* Effect.fail(refused(rule.deny))\n }\n return yield* shown(yield* run({ ...context, row: Option.none() }), principal)\n }\n const fields = [...new Set(['id', ...ruled, ...(guard.fields ?? [])])]\n const row = Option.fromUndefinedOr(yield* rowOf(source, principal, fields, target.value))\n if (\n Option.isNone(row) ||\n !Condition.holds(rule.condition, row.value, input, () => false)\n ) {\n return yield* Effect.fail(refused(rule.deny))\n }\n return yield* shown(yield* run({ ...context, row }), principal)\n }),\n )\n },\n\n /**\n * Checks, at startup, that `server` applies the guards of `entities`, the\n * Entities as `Guards.attach` returned them: each one's Source and each\n * query listing it apply its row's Read rules (`GuardDrizzle.visible`, or\n * `GuardServer.memory`), its Source applies its members' and relations'\n * (`GuardServer.filter`), and each declared write of it lands through\n * `GuardServer.writer`, all built from `policy`; and that no query's body\n * filters or orders by a member with a Read rule, which would answer for the\n * value it hides. A hand-written Source over a guarded Entity would serve\n * every row, and a bare writer would take every write; this throws instead,\n * naming each. A handler (`RemoteServer.mutation`) writes what its code\n * writes, which no check at startup can read.\n *\n * ```ts\n * GuardServer.validate(Policy, { entities: [Todo, Project], domain: Data, server: Server })\n * ```\n */\n validate: <User, R>(\n policy: Policy<User, R>,\n config: {\n readonly entities: ReadonlyArray<AnyEntity>\n /** The Remote domain the server answers, for which Entity each query lists. */\n readonly domain: {\n readonly registry: {\n readonly queries: ReadonlyMap<\n string,\n { readonly Result: unknown; readonly body?: AnyQuery | undefined }\n >\n }\n }\n readonly server: ServerDefinition<any, any>\n },\n ): void => {\n const byName = new Map(config.entities.map(entity => [entity.name, entity]))\n /** Whether who may read the rows of `entity` depends on who is asking. */\n const rowsRuled = (entity: AnyEntity | undefined) =>\n Option.exists(Option.flatMap(Option.fromUndefinedOr(entity), attached), attachment =>\n readRowsRuled(attachment),\n )\n // A query the domain does not declare lists an Entity no one can name.\n const undeclared = [...config.server.queries.keys()]\n .filter(query => !config.domain.registry.queries.has(query))\n .map(query => `query ${query} is served, but the domain does not declare it`)\n const entityProblems = config.entities.flatMap(entity =>\n Option.match(attached(entity), {\n onNone: () => [],\n onSome: attachment => {\n const name = entity.name\n if (attachment.set !== policy.set) {\n return [`${name} carries the guards of ${attachment.set}, not ${policy.set}`]\n }\n // Every guarded Entity's, whether or not it has rules there yet: a rule\n // attached later is then applied, not served past.\n const source = Option.fromUndefinedOr(config.server.entities.get(name))\n const sourceProblems = Option.match(source, {\n onNone: () => [],\n onSome: ({ visible, filter }) => [\n ...(rowRules.has(visible, policy, entity)\n ? []\n : [`${name}'s Source does not apply its Read rules`]),\n ...(memberRules.has(filter, policy, entity)\n ? []\n : [`${name}'s Source does not apply its members' Read rules`]),\n ],\n })\n const queryProblems = [...config.domain.registry.queries].flatMap(\n ([queryName, query]) => {\n const listed = config.server.queries.get(queryName)\n return listed !== undefined &&\n lists(query.Result, name) &&\n !rowRules.has(listed.visible, policy, entity)\n ? [`query ${queryName} lists ${name} without its Read rules`]\n : []\n },\n )\n // A row the reader may see with a member it may not still answers a\n // filter or an order on that member: `cost < $max`, halved twenty\n // times, reads the cost the row came back without.\n const bodyProblems = [...config.domain.registry.queries].flatMap(\n ([queryName, { body }]) => {\n if (body === undefined || body.entity.name !== name) return []\n const { predicate, order } = Query.dependencies(body)\n const hidden = (fields: typeof predicate) => [\n ...new Set(\n fields.map(field => field.key).filter(key => readRuled(attachment, key)),\n ),\n ]\n return [\n ...hidden(predicate).map(\n member =>\n `query ${queryName} filters ${name} by ${member}, which has a Read rule`,\n ),\n ...hidden(order).map(\n member => `query ${queryName} orders ${name} by ${member}, which has a Read rule`,\n ),\n ]\n },\n )\n const writeProblems = [...config.server.mutations].flatMap(([mutation, source]) =>\n source.writes !== undefined &&\n source.writes.entity === name &&\n !writeRules.has(source.writes.writer, policy, entity)\n ? [`write ${mutation} writes ${name} without its write rules`]\n : [],\n )\n // A shared field goes to every live subscriber as written: no rule may tell them apart.\n const shared = Option.match(source, {\n onNone: () => [],\n onSome: source => [...(source.shared ?? [])],\n })\n const sharedProblems = [\n ...(shared.length > 0 && readRowsRuled(attachment)\n ? [`${name}'s Source shares ${shared.join(', ')}, but its rows have a Read rule`]\n : []),\n ...shared.flatMap(member => {\n const own = readRuled(attachment, member)\n ? [`${name}'s Source shares ${member}, which has a Read rule`]\n : []\n if (!Object.hasOwn(entity.relations, member)) return own\n const target = entity.relations[member]!.target().name\n if (!byName.has(target))\n return [\n ...own,\n `${name}'s Source shares ${member}, whose ${target} is not validated`,\n ]\n return rowsRuled(byName.get(target))\n ? [...own, `${name}'s Source shares ${member}, whose rows have a Read rule`]\n : own\n }),\n ]\n // A live Source of its own streams whatever it reads: nothing here can check it.\n const liveProblems = config.server.live.has(name)\n ? [`${name} has a live Source of its own; serve its changes through a live hub`]\n : []\n return [\n ...sourceProblems,\n ...queryProblems,\n ...bodyProblems,\n ...writeProblems,\n ...sharedProblems,\n ...liveProblems,\n ]\n },\n }),\n )\n const problems = [...undeclared, ...entityProblems]\n if (problems.length > 0) {\n throw new Error(`[foldkit-guard] GuardServer.validate: ${problems.join('; ')}`)\n }\n },\n}\n\n/** Whether a read asks for `may`, of an Entity that has it (`Guards.may`). */\nconst asksMay = (entity: AnyEntity, fields: ReadonlyArray<string>) =>\n fields.includes('may') && Object.hasOwn(entity.derived, 'may')\n\n/** How one principal's `may` is answered: the fields its rules read, and the answer over a row. */\ninterface MayPlan {\n readonly fields: ReadonlyArray<string>\n readonly answer: (values: Readonly<Record<string, unknown>>) => MayAnswer\n}\n\n/** The interactions a row answers `may` for: `Update`, `Delete`, and each one the set named. */\nconst builtInRow = new Set(['Read', 'Create', 'Update', 'Delete'])\n\n/**\n * `may` for `principal`: each row interaction's rule, each member's own\n * `Update`, each relation's `Link` and `Unlink`, decided once and held over\n * each row as a write's check would hold them over it as it is.\n */\nconst mayOf = <User, R>(\n entity: AnyEntity,\n policy: Policy<User, R>,\n principal: Option.Option<User>,\n): Effect.Effect<MayPlan, never, R> => {\n const attachment = attached(entity)\n const named = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ row }) => Object.keys(row).filter(interaction => !builtInRow.has(interaction)),\n })\n const ruledMembers = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ members }) => Object.keys(members),\n })\n const ruledRelations = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ relations }) => Object.keys(relations),\n })\n return Effect.map(\n Effect.all([\n Effect.forEach(['Update', 'Delete', ...named], interaction =>\n Effect.map(\n // A named one was attached as an `InteractionKey`; its key is the name.\n policy.writable(entity, principal, interaction as InteractionKey),\n rule => [interaction, rule] as const,\n ),\n ),\n policy.writeMembers(entity, principal, ruledMembers, 'Update'),\n Effect.forEach(ruledRelations, relation =>\n Effect.map(\n Effect.all([\n policy.linkable(entity, principal, relation, 'Link'),\n policy.linkable(entity, principal, relation, 'Unlink'),\n ]),\n ([link, unlink]) => ({ relation, link, unlink }),\n ),\n ),\n ]),\n ([rows, members, relations]): MayPlan => {\n const input = policy.inputOf(principal)\n const holds = (condition: Condition, values: Readonly<Record<string, unknown>>) =>\n Condition.holds(condition, values, input, () => false)\n // A relation without a rule for one direction leaves it to the row's Update.\n const allows = (rule: Option.Option<RowRule>, values: Readonly<Record<string, unknown>>) =>\n Option.match(rule, {\n onNone: () => true,\n onSome: ({ condition }) => holds(condition, values),\n })\n const conditions = [\n ...rows.map(([, { condition }]) => condition),\n ...members.map(({ condition }) => condition),\n ...relations.flatMap(({ link, unlink }) =>\n [...Option.toArray(link), ...Option.toArray(unlink)].map(({ condition }) => condition),\n ),\n ]\n return {\n // `id` too, so a row is read when its rules read none of it (an admin's).\n fields: ['id', ...new Set(conditions.flatMap(Condition.members))],\n answer: values => ({\n row: Object.fromEntries(\n rows.map(([interaction, { condition }]) => [interaction, holds(condition, values)]),\n ),\n // Only an `explain`'s sentence is for whoever asked.\n reasons: Object.fromEntries(\n rows.flatMap(([interaction, { condition, deny }]) =>\n holds(condition, values)\n ? []\n : Match.valueTags(deny, {\n Explain: ({ reason }) => [[interaction, reason] as const],\n Forbidden: () => [],\n NotFound: () => [],\n Omit: () => [],\n Redact: () => [],\n }),\n ),\n ),\n members: Object.fromEntries(\n members.map(({ member, condition }) => [member, holds(condition, values)]),\n ),\n relations: Object.fromEntries(\n relations.map(({ relation, link, unlink }) => [\n relation,\n { Link: allows(link, values), Unlink: allows(unlink, values) },\n ]),\n ),\n }),\n }\n },\n )\n}\n\n/** A refused write as the client receives it: the sentence an `explain` gave, or none. */\nconst refused = (deny: Deny) =>\n Match.valueTags(deny, {\n Explain: ({ reason }) => RemoteServer.forbid(reason),\n Forbidden: () => RemoteServer.forbid(),\n NotFound: () => RemoteServer.forbid(),\n Omit: () => RemoteServer.forbid(),\n Redact: () => RemoteServer.forbid(),\n })\n\n/** One row, by id, as `principal` may read it through `source`. */\nconst rowOf = <P, R>(\n source: EntitySource<P, R>,\n principal: P,\n fields: ReadonlyArray<string>,\n id: string,\n) =>\n Effect.map(\n source.read({ ids: [id], fields: [...fields], principal }),\n records => records.find(record => record.id === id)?.values,\n )\n\n/**\n * Row `id` of `fields` as `principal` may see it, through `see`'s `authorize`\n * and `filter` as a Source applies them, and no more than was asked: what an\n * answer shows its writer. None when the row is not there to them.\n */\nconst seenRow = <P, R, RS>(\n see: Pick<EntitySource<P, RS>, 'authorize' | 'filter'>,\n read: (\n fields: ReadonlyArray<string>,\n ) => Effect.Effect<Option.Option<Readonly<Record<string, unknown>>>, RemoteServerError, R>,\n principal: P,\n fields: ReadonlyArray<string>,\n id: string,\n): Effect.Effect<Option.Option<Readonly<Record<string, unknown>>>, RemoteServerError, R | RS> =>\n Effect.gen(function* () {\n const allowed = see.authorize === undefined ? fields : see.authorize(principal, [...fields])\n const plan: ReadPlan =\n see.filter === undefined\n ? { fields: allowed, apply: noMembers }\n : yield* see.filter(principal, allowed)\n // The id too: a row asked for nothing else is still there or not.\n const row = yield* read([...new Set(['id', ...plan.fields])])\n return Option.map(row, values => {\n const shown = plan.apply({ id, values }).values\n return Object.fromEntries(\n allowed.filter(field => Object.hasOwn(shown, field)).map(field => [field, shown[field]]),\n )\n })\n })\n\n/** A link's value as a row holds it: the ref's key, or `null` for none. */\nconst linkKey = (link: Option.Option<{ readonly entity: string; readonly id: string }>) =>\n Option.match(link, { onNone: () => null, onSome: ref => `${ref.entity}:${ref.id}` })\n\n/** Whether a query's result is a connection over `entity`. */\nconst lists = (result: unknown, entity: string): boolean =>\n typeof result === 'object' && result !== null && 'entity' in result && result.entity === entity\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["/**\n * A guard set's read rules as `foldkit-remote-server`'s seams: an\n * `EntitySource.filter` from each member's Read rule, and `RemoteServer.memory`'s\n * `readable` and `filter` from the row's, and a check at startup that a server\n * applies them. A subpath, so the shared declaration the browser imports never\n * brings the server along.\n */\nimport { Effect, Match, Option, Schema } from 'effect'\nimport { Query, type AnyEntity, type AnyQuery } from 'foldkit-entity'\nimport type { MutationDescriptor, RemoteForbidden } from 'foldkit-remote'\nimport {\n RemoteServer,\n RemoteServerError,\n type EntityRecord,\n type EntitySource,\n type EntityWriter,\n type MutationOutcome,\n type MutationRefused,\n type MutationSource,\n type MemoryReadable,\n type ReadPlan,\n type ServerDefinition,\n} from 'foldkit-remote-server'\nimport { attached, readRowsRuled, readRuled, type Deny, type InteractionKey } from './attach.js'\nimport { Condition, type RowRule } from './condition.js'\nimport type { Policy } from './index.js'\nimport type { MayAnswer } from './may.js'\nimport { ME, type MeEntity } from './me.js'\nimport { memberRules, rowRules, writeRules } from './placed.js'\n\nconst noMembers = (record: EntityRecord) => record\n\n/** A ref key's two halves, `Entity:id`; `none` for anything else. */\nconst refOf = (value: unknown): Option.Option<{ readonly entity: string; readonly id: string }> => {\n if (typeof value !== 'string') return Option.none()\n const split = value.indexOf(':')\n return split <= 0\n ? Option.none()\n : Option.some({ entity: value.slice(0, split), id: value.slice(split + 1) })\n}\n\nexport const GuardServer = {\n /**\n * `Guards.me`'s Source: the one row, `me`, as the asker is, with `may`\n * answered by `policy`. `signedIn` is whether the server answered as\n * someone; `key` is their `key`. Any other id is no row.\n *\n * ```ts\n * RemoteServer.make({ entities: [GuardServer.me(Me, Policy), …] })\n * ```\n */\n me: <User, R>(\n entity: MeEntity,\n policy: Policy<User, R>,\n ): EntitySource<Option.Option<User>, R> => {\n // Otherwise every read would die deciding another set's guards.\n Option.map(attached(entity), ({ set }) => {\n if (set !== policy.set) {\n throw new Error(\n `[foldkit-guard] GuardServer.me: Me carries the guards of ${set}, not ${policy.set}`,\n )\n }\n })\n return {\n ...RemoteServer.entity<Option.Option<User>, R>(entity, {\n read: ({ ids, principal }) =>\n Effect.succeed(\n ids\n .filter(id => id === ME)\n .map(id => ({\n id,\n values: {\n signedIn: Option.isSome(principal),\n // Encoded, as a Source answers: `null` for a visitor.\n key: Option.match(principal, {\n onNone: () => null,\n onSome: policy.key,\n }),\n },\n })),\n ),\n filter: GuardServer.filter(entity, policy),\n }),\n // Its Read rule as this Source applies it: only the asker's own row,\n // which `Guards.me` lets anyone read. One per call: the registry is keyed\n // by it, and another call is for another Policy.\n visible: rowRules.add(Object.freeze({ reads: 'the asker’s own row' }), policy, [entity]),\n }\n },\n\n /**\n * An `EntitySource.filter` for `entity`: each requested member with a Read\n * rule is decided per record, omitted or redacted where the rule refuses.\n * The fields a rule reads are read too, so it can be decided.\n *\n * ```ts\n * RemoteServer.entity(Todo, { read, filter: GuardServer.filter(Todo, Policy) })\n * ```\n */\n filter: <User, R>(entity: AnyEntity, policy: Policy<User, R>) =>\n memberRules.add(\n (\n principal: Option.Option<User>,\n fields: readonly string[],\n ): Effect.Effect<ReadPlan, never, R> =>\n Effect.map(\n Effect.all([\n policy.readMembers(entity, principal, fields),\n // `may` is answered here, where the row is read as its principal sees it.\n asksMay(entity, fields)\n ? Effect.map(mayOf(entity, policy, principal), Option.some)\n : Effect.succeed(Option.none<MayPlan>()),\n ]),\n ([members, may]): ReadPlan => {\n if (members.length === 0 && Option.isNone(may)) return { fields, apply: noMembers }\n const input = policy.inputOf(principal)\n const decided = members.map(member => ({\n ...member,\n // A redacted value is a decoded one; the record holds what the store holds.\n redacted:\n member.deny._tag === 'Redact'\n ? Option.some(\n Schema.encodeSync(\n (\n entity.members as Readonly<\n Record<string, { readonly schema: Schema.Top }>\n >\n )[member.member]!.schema as unknown as Schema.Codec<unknown, unknown>,\n )(member.deny.value),\n )\n : Option.none(),\n }))\n return {\n fields: [\n ...new Set([\n ...fields,\n ...members.flatMap(({ condition }) => Condition.members(condition)),\n ...Option.match(may, { onNone: () => [], onSome: ({ fields }) => fields }),\n ]),\n ],\n apply: record => {\n const values: Record<string, unknown> = { ...record.values }\n for (const { member, condition, redacted } of decided) {\n // Member rules carry no inherited Read: only a row's Read may inherit.\n if (Condition.holds(condition, record.values, input, () => false)) continue\n Option.match(redacted, {\n onNone: () => {\n delete values[member]\n },\n onSome: value => {\n values[member] = value\n },\n })\n }\n Option.map(may, ({ answer }) => {\n values.may = answer(record.values)\n })\n return { id: record.id, values }\n },\n }\n },\n ),\n policy,\n [entity],\n ),\n\n /**\n * `RemoteServer.memory`'s `readable` and `filter` for `entities`, the\n * Entities as `Guards.attach` returned them. A row's Read is decided per\n * stored row, an inherited Read by looking the related row up; an Entity\n * not listed is read by everyone.\n */\n memory: <User>(policy: Policy<User>, entities: ReadonlyArray<AnyEntity>) => ({\n readable: rowRules.add(\n (\n principal: Option.Option<User>,\n row: (entity: string, id: string) => Option.Option<Readonly<Record<string, unknown>>>,\n ): Effect.Effect<MemoryReadable> =>\n Effect.map(\n Effect.forEach(entities, entity =>\n Effect.map(\n policy.readable(entity, principal),\n condition => [entity.name, condition] as const,\n ),\n ),\n (decided): MemoryReadable => {\n const conditions = new Map(decided)\n const input = policy.inputOf(principal)\n // `seen` stops a cycle of inherited Reads, which would otherwise never end.\n const holds = (\n entity: string,\n values: Readonly<Record<string, unknown>>,\n seen: ReadonlySet<string>,\n ): boolean => {\n const condition = conditions.get(entity)\n if (condition === undefined) return true\n return Condition.holds(condition, values, input, relation =>\n Option.match(refOf(values[relation]), {\n onNone: () => false,\n onSome: ref => {\n const key = `${ref.entity}:${ref.id}`\n if (seen.has(key)) return false\n return Option.match(row(ref.entity, ref.id), {\n onNone: () => false,\n onSome: target => holds(ref.entity, target, new Set([...seen, key])),\n })\n },\n }),\n )\n }\n return (entity, values) => holds(entity, values, new Set())\n },\n ),\n policy,\n entities,\n ),\n filter: Object.fromEntries(\n entities.map(entity => [entity.name, GuardServer.filter(entity, policy)] as const),\n ),\n }),\n\n /**\n * `writer` with `entity`'s write rules checked before each write lands, for\n * `RemoteServer.write`. An update or a delete reads the row first under\n * the writer's own `read` (its Source's read rule): a row the writer may not\n * see is refused as one that is not there, and a delete of it changes\n * nothing. Then the row's rule for the command must hold over the row (an\n * update's over the row as it would be after it too, so a write cannot move\n * a row out of its writer's reach), each member it sets must allow setting\n * it, and each relation it points elsewhere must allow the unlink and the\n * link. A create's rules hold over the values it proposes, where a field the\n * create leaves unset matches no guard, not even one for an empty value. A refusal is\n * `Forbidden`, with the sentence an `explain` gave; the write never runs.\n *\n * `presets` are fields a create takes from who is asking, never from the\n * client (`ownerId: user => user.id`): set before the rules are checked, so\n * a rule over them holds of the creator. A visitor has nothing to preset\n * from, and a create whose input sets a preset field is a mistake of the\n * server's, refused.\n *\n * ```ts\n * RemoteServer.write(EditTodo, GuardServer.writer(Todo, Policy, writer(Db.Todo)))\n * ```\n */\n writer: <E extends AnyEntity, User, R, RW>(\n entity: E,\n policy: Policy<User, R>,\n writer: EntityWriter<Option.Option<User>, RW>,\n options: {\n readonly presets?: {\n readonly [K in keyof E['fields']]?: (user: User) => E['fields'][K]['schema']['Type']\n }\n } = {},\n ): EntityWriter<Option.Option<User>, R | RW> => {\n const presets = Object.entries(options.presets ?? {}).map(([field, preset]) => {\n const declared = Object.hasOwn(entity.fields, field)\n ? (entity.fields as Readonly<Record<string, { readonly schema: Schema.Top }>>)[field]\n : undefined\n if (declared === undefined) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name} has no field \"${field}\" to preset`,\n )\n }\n const encode = Schema.encodeUnknownSync(\n declared.schema as unknown as Schema.Codec<unknown, unknown>,\n )\n return { field, value: (user: User) => encode((preset as (user: User) => unknown)(user)) }\n })\n if (writer.entity !== entity.name) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name}'s rules over a writer for ${writer.entity}`,\n )\n }\n const read = writer.read\n if (read === undefined) {\n throw new Error(\n `[foldkit-guard] GuardServer.writer: ${entity.name}'s writer reads no row as its writer may see it; bind it with a visible rule (GuardDrizzle.visible)`,\n )\n }\n const holds = (\n rule: { readonly condition: Condition },\n values: Readonly<Record<string, unknown>>,\n principal: Option.Option<User>,\n ) => Condition.holds(rule.condition, values, policy.inputOf(principal), () => false)\n /** Fails with the first rule of `rules` that does not hold over `values`. */\n const require = (\n rules: ReadonlyArray<{ readonly condition: Condition; readonly deny: Deny }>,\n values: Readonly<Record<string, unknown>>,\n principal: Option.Option<User>,\n ) =>\n Option.match(Option.fromUndefinedOr(rules.find(rule => !holds(rule, values, principal))), {\n onNone: () => Effect.void,\n onSome: rule => Effect.fail(refused(rule.deny)),\n })\n type Links = Readonly<\n Record<string, Option.Option<{ readonly entity: string; readonly id: string }>>\n >\n /** Each relation `links` points: its rules for unlinking and for linking a row. */\n const linkRules = (principal: Option.Option<User>, links: Links) =>\n Effect.forEach(Object.entries(links), ([relation, target]) =>\n Effect.map(\n Effect.all([\n policy.linkable(entity, principal, relation, 'Unlink'),\n policy.linkable(entity, principal, relation, 'Link'),\n ]),\n ([unlink, link]) => ({ relation, now: linkKey(target), unlink, link }),\n ),\n )\n /**\n * The rules a change from what each relation was linked to, to what it now\n * points at, must meet; none `before` is a create, which unlinks nothing.\n * Where `exact` is false, `links` are the row as its writer sees it, where\n * a link to a row hidden from them reads as none: a relation seen unlinked\n * may be linked after all, so changing it unlinks too.\n */\n const linking = (\n rules: ReadonlyArray<{\n readonly relation: string\n readonly now: string | null\n readonly unlink: Option.Option<RowRule>\n readonly link: Option.Option<RowRule>\n }>,\n before: Option.Option<{\n readonly links: Readonly<Record<string, unknown>>\n readonly exact: boolean\n }>,\n ): ReadonlyArray<RowRule> =>\n rules.flatMap(({ relation, now, unlink, link }) =>\n Option.match(before, {\n onNone: () => (now === null ? [] : Option.toArray(link)),\n onSome: ({ links, exact }) => {\n const was = links[relation] ?? null\n if (was === now && (exact || was !== null)) return []\n return [\n ...(was === null && exact ? [] : Option.toArray(unlink)),\n ...(now === null ? [] : Option.toArray(link)),\n ]\n },\n }),\n )\n const ruleOf = (\n rules: ReadonlyArray<{\n readonly unlink: Option.Option<RowRule>\n readonly link: Option.Option<RowRule>\n }>,\n ) => rules.flatMap(({ unlink, link }) => [...Option.toArray(unlink), ...Option.toArray(link)])\n const fieldsOf = (\n rules: ReadonlyArray<{ readonly condition: Condition }>,\n more: Iterable<string>,\n ) => [\n ...new Set([\n 'id',\n ...more,\n ...rules.flatMap(({ condition }) => Condition.members(condition)),\n ]),\n ]\n // What an answer shows: the row as the writer may see it, members ruled.\n const memberRead = GuardServer.filter(entity, policy)\n const guarded: EntityWriter<Option.Option<User>, R | RW> = {\n entity: writer.entity,\n read: ({ id, fields, principal }) =>\n seenRow(\n { filter: memberRead },\n seen => read({ id, fields: seen, principal }),\n principal,\n fields,\n id,\n ),\n update: context =>\n Effect.gen(function* () {\n const { principal, values, links } = context\n const row = yield* policy.writable(entity, principal, 'Update')\n const members = yield* policy.writeMembers(\n entity,\n principal,\n Object.keys(values),\n 'Update',\n )\n const relating = yield* linkRules(principal, links)\n const fields = fieldsOf([row, ...members, ...ruleOf(relating)], Object.keys(links))\n const current = yield* read({ id: context.id, fields, principal })\n if (Option.isNone(current)) return yield* Effect.fail(refused(row.deny))\n const before = current.value\n const linked = Object.keys(links)\n const stored =\n writer.linked === undefined || linked.length === 0\n ? Option.none()\n : yield* writer.linked({ id: context.id, relations: linked })\n const relations = linking(\n relating,\n Option.some(\n Option.match(stored, {\n onNone: () => ({ links: before, exact: false }),\n onSome: links => ({ links, exact: true }),\n }),\n ),\n )\n const after = {\n ...before,\n ...values,\n ...Object.fromEntries(\n Object.entries(links).map(([relation, link]) => [relation, linkKey(link)]),\n ),\n }\n yield* require([row, ...members, ...relations], before, principal)\n yield* require([row], after, principal)\n return yield* writer.update(context)\n }),\n insert: given =>\n Effect.gen(function* () {\n const preset = presets.find(({ field }) => Object.hasOwn(given.values, field))\n if (preset !== undefined) {\n return yield* new RemoteServerError({\n message: `${entity.name}'s \"${preset.field}\" is preset by the server; the input may not set it`,\n })\n }\n if (presets.length > 0 && Option.isNone(given.principal)) {\n return yield* Effect.fail(RemoteServer.forbid())\n }\n const context = Option.match(given.principal, {\n onNone: () => given,\n onSome: user => ({\n ...given,\n values: {\n ...given.values,\n ...Object.fromEntries(presets.map(({ field, value }) => [field, value(user)])),\n },\n }),\n })\n const { principal, values, links } = context\n const row = yield* policy.writable(entity, principal, 'Create')\n const members = yield* policy.writeMembers(\n entity,\n principal,\n Object.keys(values),\n 'Create',\n )\n const relations = linking(yield* linkRules(principal, links), Option.none())\n const proposed = {\n ...values,\n id: context.id,\n ...Object.fromEntries(\n Object.entries(links).map(([relation, link]) => [relation, linkKey(link)]),\n ),\n }\n const rules = [row, ...members, ...relations]\n const ruled = rules.flatMap(({ condition }) => Condition.members(condition))\n const unset = new Set(ruled.filter(field => !Object.hasOwn(proposed, field)))\n yield* require(rules.map(rule => ({\n ...rule,\n condition: Condition.unsetting(rule.condition, unset),\n })), proposed, principal)\n return yield* writer.insert(context)\n }),\n delete: context =>\n Effect.gen(function* () {\n const row = yield* policy.writable(entity, context.principal, 'Delete')\n const current = yield* read({\n id: context.id,\n fields: fieldsOf([row], []),\n principal: context.principal,\n })\n // Hidden or gone, the writer sees no row: there is nothing of theirs to delete.\n if (Option.isNone(current)) return 'absent' as const\n yield* require([row], current.value, context.principal)\n return yield* writer.delete(context)\n }),\n }\n return writeRules.add(guarded, policy, [entity])\n },\n\n /**\n * A handler's Source (`RemoteServer.mutation`'s) with `entity`'s rule for\n * `interaction` checked before it runs. The row the input names (`id`) is\n * read through `source`, which must apply the Entity's Read rules, and the\n * rule must hold over it; a row its writer may not see is refused. With no\n * `id` (a create), the rule must hold of who is asking alone, a field it\n * reads matching no guard. `run` is given the row as read: its fields the\n * rule reads, its `id`, and `fields`. A refusal is `Forbidden`; `run` never\n * runs. What `run` writes is its own: check members it sets there. Each\n * row of `entity` its answer carries is read back through `source`, so the\n * answer shows its writer only what they may see, a row it hid from them\n * as deleted.\n *\n * ```ts\n * GuardServer.mutation(ArchiveTodo, {\n * entity: Todo, policy: Policy, interaction: Archive.key,\n * id: input => input.id, source: source(Db.Todo),\n * }, ({ input, row }) => …)\n * ```\n */\n mutation: <User, R, RS, RM, Name extends string, Input, Output, Refused>(\n mutation: MutationDescriptor<Name, Input, Output, Refused>,\n guard: {\n readonly entity: AnyEntity\n readonly policy: Policy<User, R>\n readonly interaction: 'Create' | 'Update' | 'Delete' | InteractionKey\n /**\n * The row the input acts on; none for a create. An input whose id may be\n * absent (`Option`, as one editor's for create and edit) creates when it\n * is, checked against `Create`.\n */\n readonly id?: ((input: Input) => string | Option.Option<string>) | undefined\n /** Reads the row as its writer may see it: the Entity's guarded Source. */\n readonly source: EntitySource<Option.Option<User>, RS>\n /** More of the row for `run`, beside what the rule reads. */\n readonly fields?: ReadonlyArray<string> | undefined\n },\n run: (context: {\n readonly input: Input\n readonly principal: Option.Option<User>\n readonly requestId: string\n readonly row: Option.Option<Readonly<Record<string, unknown>>>\n }) => Effect.Effect<\n MutationOutcome<Output>,\n RemoteServerError | MutationRefused | RemoteForbidden,\n RM\n >,\n ): MutationSource<Option.Option<User>, R | RS | RM> => {\n const { entity, policy, interaction, id, source } = guard\n if (!rowRules.has(source.visible, policy, entity)) {\n throw new Error(\n `[foldkit-guard] GuardServer.mutation: ${mutation.name}'s Source does not apply ${entity.name}'s Read rules`,\n )\n }\n /**\n * The answer as its writer may now see it: each row of `entity` it carries\n * read back through `source`, and one the handler hid from them deleted.\n */\n const shown = (outcome: MutationOutcome<Output>, principal: Option.Option<User>) =>\n Effect.map(\n Effect.forEach(outcome.entities ?? [], patch =>\n patch.entity !== entity.name\n ? Effect.succeed(Option.some(patch))\n : Effect.map(\n seenRow(\n source,\n fields =>\n Effect.map(rowOf(source, principal, fields, patch.id), Option.fromUndefinedOr),\n principal,\n Object.keys(patch.values),\n patch.id,\n ),\n Option.map(seen => ({ ...patch, values: seen })),\n ),\n ),\n read => ({\n ...outcome,\n entities: read.flatMap(Option.toArray),\n deleted: [\n ...(outcome.deleted ?? []),\n ...(outcome.entities ?? [])\n .filter((_, index) => Option.isNone(read[index]!))\n .map(({ entity, id }) => ({ entity, id })),\n ],\n }),\n )\n return RemoteServer.mutation<Option.Option<User>, R | RS | RM, Name, Input, Output, Refused>(\n mutation,\n context =>\n Effect.gen(function* () {\n const { principal } = context\n // `context.input` was decoded against the mutation's Input before this runs.\n const target = Option.flatMap(Option.fromUndefinedOr(id), of => {\n const named = of(context.input)\n return typeof named === 'string' ? Option.some(named) : named\n })\n const rule = yield* policy.writable(\n entity,\n principal,\n id !== undefined && Option.isNone(target) ? 'Create' : interaction,\n )\n const ruled = Condition.members(rule.condition)\n const input = policy.inputOf(principal)\n if (Option.isNone(target)) {\n const unset = Condition.unsetting(rule.condition, new Set(ruled))\n if (!Condition.holds(unset, {}, input, () => false)) {\n return yield* Effect.fail(refused(rule.deny))\n }\n return yield* shown(yield* run({ ...context, row: Option.none() }), principal)\n }\n const fields = [...new Set(['id', ...ruled, ...(guard.fields ?? [])])]\n const row = Option.fromUndefinedOr(yield* rowOf(source, principal, fields, target.value))\n if (\n Option.isNone(row) ||\n !Condition.holds(rule.condition, row.value, input, () => false)\n ) {\n return yield* Effect.fail(refused(rule.deny))\n }\n return yield* shown(yield* run({ ...context, row }), principal)\n }),\n )\n },\n\n /**\n * Checks, at startup, that `server` applies the guards of `entities`, the\n * Entities as `Guards.attach` returned them: each one's Source and each\n * query listing it apply its row's Read rules (`GuardDrizzle.visible`, or\n * `GuardServer.memory`), its Source applies its members' and relations'\n * (`GuardServer.filter`), and each declared write of it lands through\n * `GuardServer.writer`, all built from `policy`; and that no query's body\n * filters or orders by a member with a Read rule, which would answer for the\n * value it hides. A hand-written Source over a guarded Entity would serve\n * every row, and a bare writer would take every write; this throws instead,\n * naming each. A handler (`RemoteServer.mutation`) writes what its code\n * writes, which no check at startup can read.\n *\n * ```ts\n * GuardServer.validate(Policy, { entities: [Todo, Project], domain: Data, server: Server })\n * ```\n */\n validate: <User, R>(\n policy: Policy<User, R>,\n config: {\n readonly entities: ReadonlyArray<AnyEntity>\n /** The Remote domain the server answers, for which Entity each query lists. */\n readonly domain: {\n readonly registry: {\n readonly queries: ReadonlyMap<\n string,\n { readonly Result: unknown; readonly body?: AnyQuery | undefined }\n >\n }\n }\n readonly server: ServerDefinition<any, any>\n },\n ): void => {\n const byName = new Map(config.entities.map(entity => [entity.name, entity]))\n /** Whether who may read the rows of `entity` depends on who is asking. */\n const rowsRuled = (entity: AnyEntity | undefined) =>\n Option.exists(Option.flatMap(Option.fromUndefinedOr(entity), attached), attachment =>\n readRowsRuled(attachment),\n )\n // A query the domain does not declare lists an Entity no one can name.\n const undeclared = [...config.server.queries.keys()]\n .filter(query => !config.domain.registry.queries.has(query))\n .map(query => `query ${query} is served, but the domain does not declare it`)\n const entityProblems = config.entities.flatMap(entity =>\n Option.match(attached(entity), {\n onNone: () => [],\n onSome: attachment => {\n const name = entity.name\n if (attachment.set !== policy.set) {\n return [`${name} carries the guards of ${attachment.set}, not ${policy.set}`]\n }\n // Every guarded Entity's, whether or not it has rules there yet: a rule\n // attached later is then applied, not served past.\n const source = Option.fromUndefinedOr(config.server.entities.get(name))\n const sourceProblems = Option.match(source, {\n onNone: () => [],\n onSome: ({ visible, filter }) => [\n ...(rowRules.has(visible, policy, entity)\n ? []\n : [`${name}'s Source does not apply its Read rules`]),\n ...(memberRules.has(filter, policy, entity)\n ? []\n : [`${name}'s Source does not apply its members' Read rules`]),\n ],\n })\n const queryProblems = [...config.domain.registry.queries].flatMap(\n ([queryName, query]) => {\n const listed = config.server.queries.get(queryName)\n return listed !== undefined &&\n lists(query.Result, name) &&\n !rowRules.has(listed.visible, policy, entity)\n ? [`query ${queryName} lists ${name} without its Read rules`]\n : []\n },\n )\n // A row the reader may see with a member it may not still answers a\n // filter or an order on that member: `cost < $max`, halved twenty\n // times, reads the cost the row came back without.\n const bodyProblems = [...config.domain.registry.queries].flatMap(\n ([queryName, { body }]) => {\n if (body === undefined || body.entity.name !== name) return []\n const { predicate, order } = Query.dependencies(body)\n const hidden = (fields: typeof predicate) => [\n ...new Set(\n fields.map(field => field.key).filter(key => readRuled(attachment, key)),\n ),\n ]\n return [\n ...hidden(predicate).map(\n member =>\n `query ${queryName} filters ${name} by ${member}, which has a Read rule`,\n ),\n ...hidden(order).map(\n member => `query ${queryName} orders ${name} by ${member}, which has a Read rule`,\n ),\n ]\n },\n )\n const writeProblems = [...config.server.mutations].flatMap(([mutation, source]) =>\n source.writes !== undefined &&\n source.writes.entity === name &&\n !writeRules.has(source.writes.writer, policy, entity)\n ? [`write ${mutation} writes ${name} without its write rules`]\n : [],\n )\n // A shared field goes to every live subscriber as written: no rule may tell them apart.\n const shared = Option.match(source, {\n onNone: () => [],\n onSome: source => [...(source.shared ?? [])],\n })\n const sharedProblems = [\n ...(shared.length > 0 && readRowsRuled(attachment)\n ? [`${name}'s Source shares ${shared.join(', ')}, but its rows have a Read rule`]\n : []),\n ...shared.flatMap(member => {\n const own = readRuled(attachment, member)\n ? [`${name}'s Source shares ${member}, which has a Read rule`]\n : []\n if (!Object.hasOwn(entity.relations, member)) return own\n const target = entity.relations[member]!.target().name\n if (!byName.has(target))\n return [\n ...own,\n `${name}'s Source shares ${member}, whose ${target} is not validated`,\n ]\n return rowsRuled(byName.get(target))\n ? [...own, `${name}'s Source shares ${member}, whose rows have a Read rule`]\n : own\n }),\n ]\n // A live Source of its own streams whatever it reads: nothing here can check it.\n const liveProblems = config.server.live.has(name)\n ? [`${name} has a live Source of its own; serve its changes through a live hub`]\n : []\n return [\n ...sourceProblems,\n ...queryProblems,\n ...bodyProblems,\n ...writeProblems,\n ...sharedProblems,\n ...liveProblems,\n ]\n },\n }),\n )\n const problems = [...undeclared, ...entityProblems]\n if (problems.length > 0) {\n throw new Error(`[foldkit-guard] GuardServer.validate: ${problems.join('; ')}`)\n }\n },\n}\n\n/** Whether a read asks for `may`, of an Entity that has it (`Guards.may`). */\nconst asksMay = (entity: AnyEntity, fields: ReadonlyArray<string>) =>\n fields.includes('may') && Object.hasOwn(entity.derived, 'may')\n\n/** How one principal's `may` is answered: the fields its rules read, and the answer over a row. */\ninterface MayPlan {\n readonly fields: ReadonlyArray<string>\n readonly answer: (values: Readonly<Record<string, unknown>>) => MayAnswer\n}\n\n/** The interactions a row answers `may` for: `Update`, `Delete`, and each one the set named. */\nconst builtInRow = new Set(['Read', 'Create', 'Update', 'Delete'])\n\n/**\n * `may` for `principal`: each row interaction's rule, each member's own\n * `Update`, each relation's `Link` and `Unlink`, decided once and held over\n * each row as a write's check would hold them over it as it is.\n */\nconst mayOf = <User, R>(\n entity: AnyEntity,\n policy: Policy<User, R>,\n principal: Option.Option<User>,\n): Effect.Effect<MayPlan, never, R> => {\n const attachment = attached(entity)\n const named = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ row }) => Object.keys(row).filter(interaction => !builtInRow.has(interaction)),\n })\n const ruledMembers = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ members }) => Object.keys(members),\n })\n const ruledRelations = Option.match(attachment, {\n onNone: () => [],\n onSome: ({ relations }) => Object.keys(relations),\n })\n return Effect.map(\n Effect.all([\n Effect.forEach(['Update', 'Delete', ...named], interaction =>\n Effect.map(\n // A named one was attached as an `InteractionKey`; its key is the name.\n policy.writable(entity, principal, interaction as InteractionKey),\n rule => [interaction, rule] as const,\n ),\n ),\n policy.writeMembers(entity, principal, ruledMembers, 'Update'),\n Effect.forEach(ruledRelations, relation =>\n Effect.map(\n Effect.all([\n policy.linkable(entity, principal, relation, 'Link'),\n policy.linkable(entity, principal, relation, 'Unlink'),\n ]),\n ([link, unlink]) => ({ relation, link, unlink }),\n ),\n ),\n ]),\n ([rows, members, relations]): MayPlan => {\n const input = policy.inputOf(principal)\n const holds = (condition: Condition, values: Readonly<Record<string, unknown>>) =>\n Condition.holds(condition, values, input, () => false)\n // A relation without a rule for one direction leaves it to the row's Update.\n const allows = (rule: Option.Option<RowRule>, values: Readonly<Record<string, unknown>>) =>\n Option.match(rule, {\n onNone: () => true,\n onSome: ({ condition }) => holds(condition, values),\n })\n const conditions = [\n ...rows.map(([, { condition }]) => condition),\n ...members.map(({ condition }) => condition),\n ...relations.flatMap(({ link, unlink }) =>\n [...Option.toArray(link), ...Option.toArray(unlink)].map(({ condition }) => condition),\n ),\n ]\n return {\n // `id` too, so a row is read when its rules read none of it (an admin's).\n fields: ['id', ...new Set(conditions.flatMap(Condition.members))],\n answer: values => ({\n row: Object.fromEntries(\n rows.map(([interaction, { condition }]) => [interaction, holds(condition, values)]),\n ),\n // Only an `explain`'s sentence is for whoever asked.\n reasons: Object.fromEntries(\n rows.flatMap(([interaction, { condition, deny }]) =>\n holds(condition, values)\n ? []\n : Match.valueTags(deny, {\n Explain: ({ reason }) => [[interaction, reason] as const],\n Forbidden: () => [],\n NotFound: () => [],\n Omit: () => [],\n Redact: () => [],\n }),\n ),\n ),\n members: Object.fromEntries(\n members.map(({ member, condition }) => [member, holds(condition, values)]),\n ),\n relations: Object.fromEntries(\n relations.map(({ relation, link, unlink }) => [\n relation,\n { Link: allows(link, values), Unlink: allows(unlink, values) },\n ]),\n ),\n }),\n }\n },\n )\n}\n\n/** A refused write as the client receives it: the sentence an `explain` gave, or none. */\nconst refused = (deny: Deny) =>\n Match.valueTags(deny, {\n Explain: ({ reason }) => RemoteServer.forbid(reason),\n Forbidden: () => RemoteServer.forbid(),\n NotFound: () => RemoteServer.forbid(),\n Omit: () => RemoteServer.forbid(),\n Redact: () => RemoteServer.forbid(),\n })\n\n/** One row, by id, as `principal` may read it through `source`. */\nconst rowOf = <P, R>(\n source: EntitySource<P, R>,\n principal: P,\n fields: ReadonlyArray<string>,\n id: string,\n) =>\n Effect.map(\n source.read({ ids: [id], fields: [...fields], principal }),\n records => records.find(record => record.id === id)?.values,\n )\n\n/**\n * Row `id` of `fields` as `principal` may see it, through `see`'s `authorize`\n * and `filter` as a Source applies them, and no more than was asked: what an\n * answer shows its writer. None when the row is not there to them.\n */\nconst seenRow = <P, R, RS>(\n see: Pick<EntitySource<P, RS>, 'authorize' | 'filter'>,\n read: (\n fields: ReadonlyArray<string>,\n ) => Effect.Effect<Option.Option<Readonly<Record<string, unknown>>>, RemoteServerError, R>,\n principal: P,\n fields: ReadonlyArray<string>,\n id: string,\n): Effect.Effect<Option.Option<Readonly<Record<string, unknown>>>, RemoteServerError, R | RS> =>\n Effect.gen(function* () {\n const allowed = see.authorize === undefined ? fields : see.authorize(principal, [...fields])\n const plan: ReadPlan =\n see.filter === undefined\n ? { fields: allowed, apply: noMembers }\n : yield* see.filter(principal, allowed)\n // The id too: a row asked for nothing else is still there or not.\n const row = yield* read([...new Set(['id', ...plan.fields])])\n return Option.map(row, values => {\n const shown = plan.apply({ id, values }).values\n return Object.fromEntries(\n allowed.filter(field => Object.hasOwn(shown, field)).map(field => [field, shown[field]]),\n )\n })\n })\n\n/** A link's value as a row holds it: the ref's key, or `null` for none. */\nconst linkKey = (link: Option.Option<{ readonly entity: string; readonly id: string }>) =>\n Option.match(link, { onNone: () => null, onSome: ref => `${ref.entity}:${ref.id}` })\n\n/** Whether a query's result is a connection over `entity`. */\nconst lists = (result: unknown, entity: string): boolean =>\n typeof result === 'object' && result !== null && 'entity' in result && result.entity === entity\n"],"mappings":"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"}
|
package/dist/sync.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { C as PrincipalGuard, S as Policy } from "./attach-
|
|
1
|
+
import { C as PrincipalGuard, S as Policy } from "./attach-BVG6LsFf.mjs";
|
|
2
2
|
import { Effect, Option } from "effect";
|
|
3
3
|
import { AnyEntity } from "foldkit-entity";
|
|
4
4
|
import { EntitySource } from "foldkit-remote-server";
|
package/dist/sync.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { t as Condition } from "./condition-
|
|
1
|
+
import { a as isAnyone, c as restricts, l as surfaceOf, r as attached } from "./attach-BZyVvs7H.mjs";
|
|
2
|
+
import { t as Condition } from "./condition-Dunujvzy.mjs";
|
|
3
3
|
import { Effect, Match, Option, Schema } from "effect";
|
|
4
4
|
//#region src/sync.ts
|
|
5
5
|
/**
|
|
@@ -60,7 +60,7 @@ const GuardSync = {
|
|
|
60
60
|
};
|
|
61
61
|
for (const member of members) if (!Object.hasOwn(entity.fields, member)) fail(`${member} is not a field of it`);
|
|
62
62
|
Option.map(attached(entity), (attachment) => {
|
|
63
|
-
for (const member of members) if (
|
|
63
|
+
for (const member of members) if (restricts(surfaceOf(attachment, {
|
|
64
64
|
_tag: "Member",
|
|
65
65
|
member,
|
|
66
66
|
interaction: "Read"
|
|
@@ -69,11 +69,11 @@ const GuardSync = {
|
|
|
69
69
|
_tag: "Row",
|
|
70
70
|
interaction: "Read"
|
|
71
71
|
});
|
|
72
|
-
if (Option.isSome(read)) {
|
|
72
|
+
if (Option.isSome(read) && restricts(read)) {
|
|
73
73
|
if (options.readers.length === 0) fail("its rows have a Read rule, so the document names its readers");
|
|
74
74
|
for (const reader of options.readers) if (!read.value.rules.some((rule) => rule._tag === "PrincipalGuard" && rule.name === reader.name && rule.set === reader.set)) fail(`${reader.name} is not in its rows' Read rule, so may not read them`);
|
|
75
75
|
}
|
|
76
|
-
if (attachment.always.some((rule) => rule._tag !== "PrincipalGuard")) fail("its `always` rules read the row, which no reader can be shown to pass");
|
|
76
|
+
if (attachment.always.some((rule) => rule._tag !== "PrincipalGuard" && !isAnyone(rule))) fail("its `always` rules read the row, which no reader can be shown to pass");
|
|
77
77
|
});
|
|
78
78
|
return Object.freeze({
|
|
79
79
|
entity,
|