@friggframework/core 2.0.0--canary.690.3fe2b27.0 → 2.0.0--canary.705.9cfd819.0

package/user/membership.js

@@ -1,51 +0,0 @@
-/**
- * Organization membership rules that are not persistence (ADR-056 §3.6). Pure.
- *
- * `IndividualUser.organizationId` is the legacy single-org pointer. It is not
- * copied into membership rows; it is read as an implicit membership here, in
- * the domain, so the repositories stay atomic (a row or nothing). See
- * docs/guides/organization-memberships.md for why this is a read-time
- * fallback rather than a data migration.
- */
-
-/** The role a membership has when nothing says otherwise. */
-const DEFAULT_ORG_ROLE = 'MEMBER';
-
-const isPresent = (value) =>
-    value !== undefined && value !== null && value !== '';
-
-const idString = (value) => (isPresent(value) ? String(value) : null);
-
-/** Ids compare as strings: stores return numbers or strings. */
-const sameId = (a, b) => isPresent(a) && isPresent(b) && String(a) === String(b);
-
-/**
- * The membership the legacy `organizationId` pointer stands for in
- * `organizationUserId`, or null when the person has no pointer or it names a
- * different organization.
- *
- * @param {Object|null} individual The individual user as the repository returns it.
- * @param {string|number} organizationUserId
- * @returns {{id: null, individualUserId: string|null, organizationUserId: string, orgRole: string, createdAt: *, implicit: true}|null}
- */
-function implicitMembership(individual, organizationUserId) {
-    if (!individual || !sameId(individual.organizationId, organizationUserId)) {
-        return null;
-    }
-    return {
-        id: null,
-        individualUserId: idString(individual.id),
-        organizationUserId: idString(individual.organizationId),
-        orgRole: DEFAULT_ORG_ROLE,
-        createdAt: individual.createdAt,
-        implicit: true,
-    };
-}
-
-module.exports = {
-    DEFAULT_ORG_ROLE,
-    isPresent,
-    idString,
-    sameId,
-    implicitMembership,
-};

package/user/repositories/organization-membership-record.js

@@ -1,19 +0,0 @@
-const { idString } = require('../membership');
-
-/**
- * A stored membership row as the application sees it: every id a string
- * whatever the database holds. `implicit` is always false here: only the
- * domain (`user/membership.js`) produces an implicit membership.
- */
-function toMembership(row) {
-    return {
-        id: idString(row.id ?? row._id),
-        individualUserId: idString(row.individualUserId),
-        organizationUserId: idString(row.organizationUserId),
-        orgRole: row.orgRole,
-        createdAt: row.createdAt,
-        implicit: false,
-    };
-}
-
-module.exports = { toMembership };

package/user/repositories/organization-membership-repository-documentdb.js

@@ -1,106 +0,0 @@
-const { prisma } = require('../../database/prisma');
-const {
-    toObjectId,
-    fromObjectId,
-    findOne,
-    findManyDrained,
-    updateOne,
-} = require('../../database/documentdb-utils');
-const { DUPLICATE_KEY_CODE } = require('../../database/unique-violation');
-const {
-    OrganizationMembershipRepositoryInterface,
-} = require('./organization-membership-repository-interface');
-const { toMembership } = require('./organization-membership-record');
-const { DEFAULT_ORG_ROLE } = require('../membership');
-
-const COLLECTION = 'OrganizationMembership';
-
-const parseDate = (value) => {
-    if (!value) return undefined;
-    const date = new Date(value.$date ?? value);
-    return Number.isNaN(date.getTime()) ? undefined : date;
-};
-
-/**
- * Organization membership persistence for DocumentDB through raw commands.
- * Nothing in a membership is encrypted.
- */
-class OrganizationMembershipRepositoryDocumentDB extends OrganizationMembershipRepositoryInterface {
-    constructor() {
-        super();
-        this.prisma = prisma;
-    }
-
-    async findMembership(individualUserId, organizationUserId) {
-        const doc = await this._findDoc(individualUserId, organizationUserId);
-        return doc ? this._toMembership(doc) : null;
-    }
-
-    async addMembership(individualUserId, organizationUserId, options = {}) {
-        // $setOnInsert: an existing membership is left exactly as it is.
-        const result = await updateOne(
-            this.prisma,
-            COLLECTION,
-            this._pair(individualUserId, organizationUserId),
-            {
-                $setOnInsert: {
-                    orgRole: options.orgRole ?? DEFAULT_ORG_ROLE,
-                    createdAt: new Date(),
-                },
-            },
-            { upsert: true }
-        );
-        // The loser of a first-login race can hit the unique pair; the row
-        // exists then, so only other write errors are failures.
-        const writeError = result?.writeErrors?.[0];
-        if (writeError && writeError.code !== DUPLICATE_KEY_CODE) {
-            throw new Error(
-                `Adding organization membership failed: ${writeError.errmsg} (code: ${writeError.code})`
-            );
-        }
-        const doc = await this._findDoc(individualUserId, organizationUserId);
-        if (!doc) {
-            throw new Error('Organization membership was not stored');
-        }
-        return this._toMembership(doc);
-    }
-
-    async listMembershipsForOrganization(organizationUserId) {
-        // Drained: findMany returns only the first cursor batch (~101 documents),
-        // which would silently drop members of a large organization.
-        const docs = await findManyDrained(
-            this.prisma,
-            COLLECTION,
-            { organizationUserId: toObjectId(organizationUserId) },
-            { sort: { createdAt: 1 } }
-        );
-        return docs.map((doc) => this._toMembership(doc));
-    }
-
-    _pair(individualUserId, organizationUserId) {
-        return {
-            individualUserId: toObjectId(individualUserId),
-            organizationUserId: toObjectId(organizationUserId),
-        };
-    }
-
-    async _findDoc(individualUserId, organizationUserId) {
-        return findOne(
-            this.prisma,
-            COLLECTION,
-            this._pair(individualUserId, organizationUserId)
-        );
-    }
-
-    _toMembership(doc) {
-        return toMembership({
-            id: fromObjectId(doc._id),
-            individualUserId: fromObjectId(doc.individualUserId),
-            organizationUserId: fromObjectId(doc.organizationUserId),
-            orgRole: doc.orgRole ?? DEFAULT_ORG_ROLE,
-            createdAt: parseDate(doc.createdAt),
-        });
-    }
-}
-
-module.exports = { OrganizationMembershipRepositoryDocumentDB };

package/user/repositories/organization-membership-repository-factory.js

@@ -1,42 +0,0 @@
-const databaseConfig = require('../../database/config');
-const {
-    OrganizationMembershipRepositoryMongo,
-} = require('./organization-membership-repository-mongo');
-const {
-    OrganizationMembershipRepositoryPrisma,
-} = require('./organization-membership-repository-prisma');
-const {
-    OrganizationMembershipRepositoryPostgres,
-} = require('./organization-membership-repository-postgres');
-const {
-    OrganizationMembershipRepositoryDocumentDB,
-} = require('./organization-membership-repository-documentdb');
-
-/**
- * Membership repository for the configured database. Every method returns
- * String ids whatever the database stores.
- *
- * @returns {import('./organization-membership-repository-interface').OrganizationMembershipRepositoryInterface}
- */
-function createOrganizationMembershipRepository() {
-    switch (databaseConfig.DB_TYPE) {
-        case 'mongodb':
-            return new OrganizationMembershipRepositoryMongo();
-        case 'postgresql':
-            return new OrganizationMembershipRepositoryPostgres();
-        case 'documentdb':
-            return new OrganizationMembershipRepositoryDocumentDB();
-        default:
-            throw new Error(
-                `Unsupported DB_TYPE: ${databaseConfig.DB_TYPE}. Supported values: 'mongodb', 'documentdb', 'postgresql'`
-            );
-    }
-}
-
-module.exports = {
-    createOrganizationMembershipRepository,
-    OrganizationMembershipRepositoryPrisma,
-    OrganizationMembershipRepositoryMongo,
-    OrganizationMembershipRepositoryPostgres,
-    OrganizationMembershipRepositoryDocumentDB,
-};

package/user/repositories/organization-membership-repository-interface.js

@@ -1,57 +0,0 @@
-/**
- * Organization Membership Repository Interface (ADR-056 §3.6).
- *
- * Atomic persistence of "this person belongs to that organization": a row or
- * nothing. No policy and no reading of `IndividualUser.organizationId`: the
- * legacy pointer counts as an implicit membership, and that rule lives in the
- * domain (`user/membership.js`), applied by the use cases.
- *
- * Every method returns String ids whatever the database stores.
- *
- * @abstract
- */
-class OrganizationMembershipRepositoryInterface {
-    /**
-     * @param {string|number} individualUserId
-     * @param {string|number} organizationUserId
-     * @returns {Promise<Object|null>} The stored membership, or null.
-     * @abstract
-     */
-    async findMembership(individualUserId, organizationUserId) {
-        throw new Error('Method findMembership must be implemented by subclass');
-    }
-
-    /**
-     * Adds a membership if there is none; never changes an existing one.
-     * Idempotent, and safe against a concurrent identical call: both resolve
-     * to the same row.
-     *
-     * @param {string|number} individualUserId
-     * @param {string|number} organizationUserId
-     * @param {Object} [options]
-     * @param {string|null} [options.orgRole] Stored only when the row is
-     *   created; defaults to `MEMBER`.
-     * @returns {Promise<Object>} The stored membership.
-     * @abstract
-     */
-    async addMembership(individualUserId, organizationUserId, options) {
-        throw new Error('Method addMembership must be implemented by subclass');
-    }
-
-    /**
-     * Stored memberships of an organization, oldest first. Rows only: people
-     * who are in the organization through the legacy pointer alone are not
-     * here.
-     *
-     * @param {string|number} organizationUserId
-     * @returns {Promise<Object[]>}
-     * @abstract
-     */
-    async listMembershipsForOrganization(organizationUserId) {
-        throw new Error(
-            'Method listMembershipsForOrganization must be implemented by subclass'
-        );
-    }
-}
-
-module.exports = { OrganizationMembershipRepositoryInterface };

package/user/repositories/organization-membership-repository-mongo.js

@@ -1,13 +0,0 @@
-const {
-    OrganizationMembershipRepositoryPrisma,
-} = require('./organization-membership-repository-prisma');
-
-/** Organization membership persistence for MongoDB: ids are ObjectId strings, used as they are. */
-class OrganizationMembershipRepositoryMongo extends OrganizationMembershipRepositoryPrisma {
-    /** @protected */
-    _toDbId(id) {
-        return id;
-    }
-}
-
-module.exports = { OrganizationMembershipRepositoryMongo };

package/user/repositories/organization-membership-repository-postgres.js

@@ -1,29 +0,0 @@
-const {
-    OrganizationMembershipRepositoryPrisma,
-} = require('./organization-membership-repository-prisma');
-
-/**
- * Organization membership persistence for PostgreSQL. The database keys are
- * Int, the application's are strings, so ids are converted in and the record
- * mapper stringifies them out.
- */
-class OrganizationMembershipRepositoryPostgres extends OrganizationMembershipRepositoryPrisma {
-    /**
-     * Strict: digits only. `parseInt` would turn '12abc' into 12 and query
-     * the wrong person.
-     * @protected
-     */
-    _toDbId(id) {
-        const text = typeof id === 'number' ? String(id) : id;
-        if (typeof text !== 'string' || !/^\d+$/.test(text)) {
-            throw new Error(`Invalid ID: ${id} cannot be converted to integer`);
-        }
-        const parsed = Number(text);
-        if (!Number.isSafeInteger(parsed)) {
-            throw new Error(`Invalid ID: ${id} cannot be converted to integer`);
-        }
-        return parsed;
-    }
-}
-
-module.exports = { OrganizationMembershipRepositoryPostgres };

package/user/repositories/organization-membership-repository-prisma.js

@@ -1,81 +0,0 @@
-const { prisma } = require('../../database/prisma');
-const { isUniqueViolation } = require('../../database/unique-violation');
-const {
-    OrganizationMembershipRepositoryInterface,
-} = require('./organization-membership-repository-interface');
-const { toMembership } = require('./organization-membership-record');
-
-/**
- * Organization membership persistence through the Prisma client. Both schemas
- * declare the same model; they differ only in the id type, which the subclass
- * supplies through `_toDbId` (MongoDB: ObjectId strings, PostgreSQL: Int).
- *
- * @abstract
- */
-class OrganizationMembershipRepositoryPrisma extends OrganizationMembershipRepositoryInterface {
-    constructor(prismaClient = prisma) {
-        super();
-        this.prisma = prismaClient;
-    }
-
-    /**
-     * @protected
-     * @abstract
-     */
-    _toDbId(id) {
-        throw new Error('Method _toDbId must be implemented by subclass');
-    }
-
-    async findMembership(individualUserId, organizationUserId) {
-        const row = await this._findRow(individualUserId, organizationUserId);
-        return row ? toMembership(row) : null;
-    }
-
-    async addMembership(individualUserId, organizationUserId, options = {}) {
-        const pair = this._pair(individualUserId, organizationUserId);
-        try {
-            const row = await this.prisma.organizationMembership.upsert({
-                where: { individualUserId_organizationUserId: pair },
-                // `undefined` lets the column default (MEMBER) apply.
-                create: { ...pair, orgRole: options.orgRole ?? undefined },
-                update: {},
-            });
-            return toMembership(row);
-        } catch (error) {
-            // Two first logins can both miss the row and both try to create it.
-            // The loser's insert hits the unique pair; the row is there now.
-            if (!isUniqueViolation(error)) throw error;
-            const row = await this._findRow(individualUserId, organizationUserId);
-            if (!row) throw error;
-            return toMembership(row);
-        }
-    }
-
-    async listMembershipsForOrganization(organizationUserId) {
-        const rows = await this.prisma.organizationMembership.findMany({
-            where: { organizationUserId: this._toDbId(organizationUserId) },
-            orderBy: { createdAt: 'asc' },
-        });
-        return rows.map(toMembership);
-    }
-
-    _pair(individualUserId, organizationUserId) {
-        return {
-            individualUserId: this._toDbId(individualUserId),
-            organizationUserId: this._toDbId(organizationUserId),
-        };
-    }
-
-    async _findRow(individualUserId, organizationUserId) {
-        return this.prisma.organizationMembership.findUnique({
-            where: {
-                individualUserId_organizationUserId: this._pair(
-                    individualUserId,
-                    organizationUserId
-                ),
-            },
-        });
-    }
-}
-
-module.exports = { OrganizationMembershipRepositoryPrisma };

package/user/tests/doubles/adopter-jwt-fixtures.js

@@ -1,220 +0,0 @@
-/* eslint-disable camelcase -- JWT claim names (org_id, org_role) and reason codes are snake_case by spec */
-const jose = require('jose');
-
-/**
- * Key material and token signing for adopter-JWT tests. Real keys and real
- * signatures: nothing here fakes the verifier.
- */
-async function createKeys() {
-    const es = await jose.generateKeyPair('ES256');
-    const rs = await jose.generateKeyPair('RS256');
-    const attacker = await jose.generateKeyPair('ES256');
-    const publicJwks = {
-        keys: [
-            {
-                ...(await jose.exportJWK(es.publicKey)),
-                kid: 'es-1',
-                alg: 'ES256',
-                use: 'sig',
-            },
-            {
-                ...(await jose.exportJWK(rs.publicKey)),
-                kid: 'rs-1',
-                alg: 'RS256',
-                use: 'sig',
-            },
-        ],
-    };
-    return {
-        es,
-        rs,
-        attacker,
-        publicJwks,
-        localJwks: jose.createLocalJWKSet(publicJwks),
-        hmacSecret: 'a-shared-secret-that-is-long-enough-for-hs256',
-    };
-}
-
-/**
- * @param {Object} claims
- * @param {Object} opts
- * @param {Object|Uint8Array} opts.key - signing key
- * @param {string} [opts.alg='ES256']
- * @param {string} [opts.kid]
- * @param {string|null} [opts.exp='5m'] - null omits exp
- */
-async function signToken(
-    claims,
-    { key, alg = 'ES256', kid, exp = '5m', iss, aud, nbf } = {}
-) {
-    const jwt = new jose.SignJWT(claims)
-        .setProtectedHeader(kid ? { alg, kid } : { alg })
-        .setIssuedAt();
-    if (exp !== null) jwt.setExpirationTime(exp);
-    if (iss) jwt.setIssuer(iss);
-    if (aud) jwt.setAudience(aud);
-    if (nbf) jwt.setNotBefore(nbf);
-    return jwt.sign(key);
-}
-
-const b64url = (value) =>
-    Buffer.from(JSON.stringify(value)).toString('base64url');
-
-/** An unsigned token: `alg: none`, empty signature. */
-function unsignedToken(claims) {
-    return `${b64url({ alg: 'none', typ: 'JWT' })}.${b64url({
-        ...claims,
-        exp: Math.floor(Date.now() / 1000) + 300,
-    })}.`;
-}
-
-/**
- * Resolves each `wait()` only once `parties` callers have arrived, so a test
- * can make concurrent requests all read before any of them writes.
- */
-function createBarrier(parties) {
-    let arrived = 0;
-    let release;
-    const gate = new Promise((resolve) => {
-        release = resolve;
-    });
-    return {
-        async wait() {
-            arrived += 1;
-            if (arrived >= parties) release();
-            await gate;
-        },
-    };
-}
-
-/**
- * Stateful fake of the user repository, built from jest.fn so every call is
- * observable. Individuals carry `organizationId`, as the real repositories
- * return it. Like the database, it refuses a second individual with the same
- * `appUserId` (a Prisma-shaped `P2002`), which is what a first-login race hits.
- *
- * @param {Object} [options]
- * @param {number} [options.findBarrier] Make the first N calls to
- *   `findIndividualUserByAppUserId` wait for each other (see createBarrier).
- */
-function createUserRepositoryDouble({
-    individuals = [],
-    organizations = [],
-    findBarrier = 0,
-} = {}) {
-    const individualUsers = new Map(
-        individuals.map((u) => [u.appUserId, { ...u }])
-    );
-    const organizationUsers = new Map(
-        organizations.map((o) => [o.appOrgId, { ...o }])
-    );
-    const barrier = findBarrier > 1 ? createBarrier(findBarrier) : null;
-    let barrierCalls = 0;
-    let seq = 0;
-
-    const repo = {
-        findIndividualUserByAppUserId: jest.fn(async (appUserId) => {
-            const found = individualUsers.get(appUserId) ?? null;
-            if (barrier && barrierCalls < findBarrier) {
-                barrierCalls += 1;
-                await barrier.wait();
-            }
-            return found && { ...found };
-        }),
-        findOrganizationUserByAppOrgId: jest.fn(
-            async (appOrgId) => organizationUsers.get(appOrgId) ?? null
-        ),
-        createIndividualUser: jest.fn(async (params) => {
-            if (individualUsers.has(params.appUserId)) {
-                throw Object.assign(
-                    new Error('Unique constraint failed on appUserId'),
-                    { code: 'P2002' }
-                );
-            }
-            const created = {
-                id: `ind-${++seq}`,
-                organizationId: undefined,
-                ...params,
-            };
-            individualUsers.set(created.appUserId, created);
-            return { ...created };
-        }),
-        createOrganizationUser: jest.fn(async (params) => {
-            const created = { id: `org-${++seq}`, ...params };
-            organizationUsers.set(created.appOrgId, created);
-            return created;
-        }),
-        findIndividualUserById: jest.fn(async (id) => {
-            for (const u of individualUsers.values()) {
-                if (u.id === id) return { ...u };
-            }
-            return null;
-        }),
-        // Like the database: sets the pointer only while it is unset.
-        linkIndividualToOrganizationIfUnset: jest.fn(
-            async (individualId, organizationId) => {
-                for (const u of individualUsers.values()) {
-                    if (u.id !== individualId) continue;
-                    const unset =
-                        u.organizationId === undefined ||
-                        u.organizationId === null ||
-                        u.organizationId === '';
-                    if (unset) u.organizationId = organizationId;
-                    return { ...u };
-                }
-                return null;
-            }
-        ),
-    };
-    repo.state = { individualUsers, organizationUsers };
-    return repo;
-}
-
-/**
- * In-memory organization membership repository: atomic, like the real ones. The
- * pair is unique and `addMembership` is an upsert. It knows nothing of the
- * legacy `organizationId` pointer; the domain (user/membership.js) does.
- */
-function createMembershipRepositoryDouble() {
-    const { toMembership } = require('../../repositories/organization-membership-record');
-    const rows = new Map();
-    const key = (i, o) => `${i}|${o}`;
-    let seq = 0;
-
-    const repo = {
-        findMembership: jest.fn(async (individualId, organizationId) => {
-            const row = rows.get(key(individualId, organizationId));
-            return row ? toMembership(row) : null;
-        }),
-        addMembership: jest.fn(
-            async (individualId, organizationId, { orgRole } = {}) => {
-                const k = key(individualId, organizationId);
-                if (!rows.has(k)) {
-                    rows.set(k, {
-                        id: `mem-${++seq}`,
-                        individualUserId: individualId,
-                        organizationUserId: organizationId,
-                        orgRole: orgRole ?? 'MEMBER',
-                        createdAt: new Date(),
-                    });
-                }
-                return toMembership(rows.get(k));
-            }
-        ),
-        listMembershipsForOrganization: jest.fn(async (organizationId) =>
-            [...rows.values()]
-                .filter((r) => r.organizationUserId === organizationId)
-                .map(toMembership)
-        ),
-    };
-    repo.rows = rows;
-    return repo;
-}
-
-module.exports = {
-    createKeys,
-    signToken,
-    unsignedToken,
-    createUserRepositoryDouble,
-    createMembershipRepositoryDouble,
-};