@brandtg/flapjack 1.3.0 → 1.5.0

package/dist/model.js

@@ -1,5 +1,7 @@
 import MurmurHash3 from "imurmurhash";
 const TABLE = "flapjack.feature_flag";
+const SUBJECT_TABLE = "flapjack.feature_flag_subject";
+const GROUP_SUBJECT_TABLE = "flapjack.feature_flag_group_subject";
 const COLUMNS = [
     "id",
     "name",
@@ -8,10 +10,12 @@ const COLUMNS = [
     "roles",
     "groups",
     "users",
+    "tags",
     "note",
     "created",
     "modified",
     "expires",
+    "archived",
 ];
 function mapRow(row) {
     return {
@@ -26,10 +30,12 @@ function mapRow(row) {
             ? row.groups
             : undefined,
         users: row.users && row.users.length > 0 ? row.users : undefined,
+        tags: row.tags && row.tags.length > 0 ? row.tags : undefined,
         note: row.note ?? undefined,
         created: new Date(row.created),
         modified: new Date(row.modified),
         expires: row.expires ? new Date(row.expires) : undefined,
+        archived: row.archived ? new Date(row.archived) : undefined,
     };
 }
 /**
@@ -73,6 +79,7 @@ export class FeatureFlagModel {
      * @param input.roles - Optional list of roles that have this flag enabled
      * @param input.groups - Optional list of user groups that have this flag enabled
      * @param input.users - Optional list of specific user IDs that have this flag enabled
+     * @param input.tags - Optional list of tags for organizing the flag (e.g. a release version)
      * @param input.note - Optional description of the flag's purpose
      * @param input.expires - Optional expiration date for the feature flag
      * @returns The created feature flag with generated id, created, and modified timestamps
@@ -111,6 +118,10 @@ export class FeatureFlagModel {
             cols.push("users");
             vals.push(input.users ?? null);
         }
+        if ("tags" in input) {
+            cols.push("tags");
+            vals.push(input.tags ?? null);
+        }
         if ("note" in input) {
             cols.push("note");
             vals.push(input.note ?? null);
@@ -138,8 +149,9 @@ export class FeatureFlagModel {
      * }
      * ```
      */
-    async getById(id) {
-        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE id = $1`;
+    async getById(id, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE id = $1${filter}`;
         const res = await this.db.query(sql, [id]);
         if (res.rows.length === 0)
             return null;
@@ -159,8 +171,9 @@ export class FeatureFlagModel {
      * }
      * ```
      */
-    async getByName(name) {
-        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE name = $1`;
+    async getByName(name, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE name = $1${filter}`;
         const res = await this.db.query(sql, [name]);
         if (res.rows.length === 0)
             return null;
@@ -178,10 +191,11 @@ export class FeatureFlagModel {
      * console.log(`Found ${flags.length} flags`);
      * ```
      */
-    async getManyByName(names) {
+    async getManyByName(names, { includeArchived = false } = {}) {
         if (names.length === 0)
             return [];
-        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE name = ANY($1)`;
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE name = ANY($1)${filter}`;
         const res = await this.db.query(sql, [names]);
         return res.rows.map(mapRow);
     }
@@ -197,10 +211,11 @@ export class FeatureFlagModel {
      * console.log(`Found ${flags.length} flags`);
      * ```
      */
-    async getMany(ids) {
+    async getMany(ids, { includeArchived = false } = {}) {
         if (ids.length === 0)
             return [];
-        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE id = ANY($1)`;
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE id = ANY($1)${filter}`;
         const res = await this.db.query(sql, [ids]);
         return res.rows.map(mapRow);
     }
@@ -218,11 +233,30 @@ export class FeatureFlagModel {
      * });
      * ```
      */
-    async list() {
-        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} ORDER BY id`;
+    async list({ includeArchived = false, } = {}) {
+        const filter = includeArchived ? "" : " WHERE archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE}${filter} ORDER BY id`;
         const res = await this.db.query(sql);
         return res.rows.map(mapRow);
     }
+    /**
+     * Retrieves all feature flags that carry the given tag.
+     *
+     * @param tag - The tag to filter by (exact match against a tag in the flag's tags array)
+     * @returns Array of feature flags tagged with the given value
+     *
+     * @example
+     * ```typescript
+     * // Find every flag associated with a release version
+     * const flags = await model.listByTag("release:1.5.0");
+     * ```
+     */
+    async listByTag(tag, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${COLUMNS.join(", ")} FROM ${TABLE} WHERE $1 = ANY(tags)${filter} ORDER BY id`;
+        const res = await this.db.query(sql, [tag]);
+        return res.rows.map(mapRow);
+    }
     /**
      * Updates an existing feature flag.
      *
@@ -274,6 +308,10 @@ export class FeatureFlagModel {
             sets.push(`users = $${sets.length + 1}`);
             vals.push(changes.users ?? null);
         }
+        if ("tags" in changes) {
+            sets.push(`tags = $${sets.length + 1}`);
+            vals.push(changes.tags ?? null);
+        }
         if ("note" in changes) {
             sets.push(`note = $${sets.length + 1}`);
             vals.push(changes.note ?? null);
@@ -294,11 +332,16 @@ export class FeatureFlagModel {
         return mapRow(res.rows[0]);
     }
     /**
-     * Deletes a feature flag from the database.
+     * Permanently deletes a feature flag from the database, including its
+     * subject and group-member relationships (via ON DELETE CASCADE).
      *
      * @param id - The unique identifier of the feature flag to delete
      * @returns true if the flag was deleted, false if not found
      *
+     * @remarks
+     * This is a hard delete that destroys all metadata. To hide a flag while
+     * retaining its history for audit purposes, use {@link archive} instead.
+     *
      * @example
      * ```typescript
      * const deleted = await model.delete(flagId);
@@ -311,6 +354,105 @@ export class FeatureFlagModel {
         const res = await this.db.query(`DELETE FROM ${TABLE} WHERE id = $1`, [id]);
         return res.rowCount > 0;
     }
+    /**
+     * Archives (hides) a feature flag while keeping the row for historical/audit
+     * purposes. Archived flags are excluded from normal reads and evaluation
+     * (an archived flag evaluates to inactive), but can still be retrieved by
+     * passing `{ includeArchived: true }` to the read methods.
+     *
+     * @param id - The unique identifier of the feature flag to archive
+     * @returns The archived feature flag, or null if it does not exist or is already archived
+     *
+     * @remarks
+     * Archiving is irreversible: there is intentionally no `unarchive` method.
+     * The `archived` timestamp is set once and never changed (a second call is a
+     * no-op that returns null). The flag's name remains reserved permanently, so
+     * a new flag cannot reuse it — create a new flag with a different name.
+     *
+     * @example
+     * ```typescript
+     * const archived = await model.archive(flagId);
+     * if (archived) {
+     *   console.log(`Archived at ${archived.archived}`);
+     * }
+     * ```
+     */
+    async archive(id) {
+        const sql = `UPDATE ${TABLE} SET archived = now() WHERE id = $1 AND archived IS NULL RETURNING ${COLUMNS.join(", ")}`;
+        const res = await this.db.query(sql, [id]);
+        if (res.rows.length === 0)
+            return null;
+        return mapRow(res.rows[0]);
+    }
+    /**
+     * Adds an external subject identifier to a feature flag.
+     */
+    async addSubject(featureFlagId, subject) {
+        try {
+            const sql = `INSERT INTO ${SUBJECT_TABLE} (feature_flag_id, subject) VALUES ($1, $2)`;
+            await this.db.query(sql, [featureFlagId, subject]);
+            return true;
+        }
+        catch (err) {
+            if (err.code === "23505") {
+                return false;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Removes an external subject identifier from a feature flag.
+     */
+    async removeSubject(featureFlagId, subject) {
+        const sql = `DELETE FROM ${SUBJECT_TABLE} WHERE feature_flag_id = $1 AND subject = $2`;
+        const res = await this.db.query(sql, [featureFlagId, subject]);
+        return res.rowCount > 0;
+    }
+    /**
+     * Gets all external subject identifiers associated with a feature flag.
+     */
+    async getSubjects(featureFlagId) {
+        const sql = `SELECT subject FROM ${SUBJECT_TABLE} WHERE feature_flag_id = $1 ORDER BY created DESC`;
+        const res = await this.db.query(sql, [featureFlagId]);
+        return res.rows.map((row) => row.subject);
+    }
+    /**
+     * Gets all feature flags directly associated with an external subject identifier.
+     */
+    async getFeatureFlagsForSubject(subject, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND f.archived IS NULL";
+        const sql = `
+      SELECT ${COLUMNS.map((c) => `f.${c}`).join(", ")}
+      FROM ${TABLE} f
+      INNER JOIN ${SUBJECT_TABLE} s ON f.id = s.feature_flag_id
+      WHERE s.subject = $1${filter}
+      ORDER BY f.created DESC
+    `;
+        const res = await this.db.query(sql, [subject]);
+        return res.rows.map(mapRow);
+    }
+    async getSubjectMatchedFlagIds(subjects = []) {
+        if (subjects.length === 0) {
+            return new Set();
+        }
+        // Archived flags and archived groups do not contribute subject-based
+        // targeting: a flag matched directly must itself be active, and a flag
+        // matched via group membership must belong to an active group.
+        const sql = `
+      SELECT s.feature_flag_id AS feature_flag_id
+      FROM ${SUBJECT_TABLE} s
+      INNER JOIN ${TABLE} f ON f.id = s.feature_flag_id
+      WHERE s.subject = ANY($1) AND f.archived IS NULL
+      UNION
+      SELECT gm.feature_flag_id AS feature_flag_id
+      FROM ${GROUP_SUBJECT_TABLE} gs
+      INNER JOIN ${GROUP_MEMBER_TABLE} gm ON gs.feature_flag_group_id = gm.group_id
+      INNER JOIN ${GROUP_TABLE} g ON g.id = gs.feature_flag_group_id
+      WHERE gs.subject = ANY($1) AND g.archived IS NULL
+    `;
+        const res = await this.db.query(sql, [subjects]);
+        return new Set(res.rows.map((row) => Number(row.feature_flag_id)));
+    }
     /**
      * Checks if a user belongs to any of the specified groups
      */
@@ -323,7 +465,7 @@ export class FeatureFlagModel {
      * Evaluates a feature flag for a user based on flag configuration.
      * This is a stateless helper that performs the actual flag evaluation logic.
      */
-    async evaluateFlagForUser(flag, { user, roles, groups, }) {
+    async evaluateFlagForUser(flag, { user, roles, groups, subjects, subjectMatchedFlagIds, }) {
         // Everyone Override: If everyone is true or false, return that value immediately
         if (flag.everyone !== undefined && flag.everyone !== null) {
             return flag.everyone;
@@ -332,6 +474,20 @@ export class FeatureFlagModel {
         if (user && flag.users && flag.users.includes(user)) {
             return true;
         }
+        // Subject Check: If any external subject maps to this flag directly or via group, return true
+        if (subjects && subjects.length > 0) {
+            let isSubjectMatched = false;
+            if (subjectMatchedFlagIds) {
+                isSubjectMatched = subjectMatchedFlagIds.has(flag.id);
+            }
+            else {
+                const matchedFlagIds = await this.getSubjectMatchedFlagIds(subjects);
+                isSubjectMatched = matchedFlagIds.has(flag.id);
+            }
+            if (isSubjectMatched) {
+                return true;
+            }
+        }
         // Group Check: If any of the user's groups match any group in the groups array, return true
         if (groups && this.isActiveForGroups(groups, flag.groups)) {
             return true;
@@ -414,6 +570,17 @@ export class FeatureFlagModel {
      * ```
      */
     async isActiveForUser({ name, user, roles, groups, }) {
+        return this.isActiveForContext({
+            name,
+            user,
+            roles,
+            groups,
+        });
+    }
+    /**
+     * Checks if a feature flag is active for a context, including optional external subjects.
+     */
+    async isActiveForContext({ name, user, roles, groups, subjects, }) {
         const flag = await this.getByName(name);
         // No such flag
         if (!flag) {
@@ -429,7 +596,14 @@ export class FeatureFlagModel {
                 return expiredResult;
             }
         }
-        return this.evaluateFlagForUser(flag, { user, roles, groups });
+        const subjectMatchedFlagIds = await this.getSubjectMatchedFlagIds(subjects);
+        return this.evaluateFlagForUser(flag, {
+            user,
+            roles,
+            groups,
+            subjects,
+            subjectMatchedFlagIds,
+        });
     }
     /**
      * Checks if multiple feature flags are active for a user based on configured rules.
@@ -479,6 +653,17 @@ export class FeatureFlagModel {
      * ```
      */
     async areActiveForUser({ names, user, roles, groups, }) {
+        return this.areActiveForContext({
+            names,
+            user,
+            roles,
+            groups,
+        });
+    }
+    /**
+     * Checks if multiple feature flags are active for a context, including optional external subjects.
+     */
+    async areActiveForContext({ names, user, roles, groups, subjects, }) {
         let flags;
         let requestedNames;
         if (names === undefined) {
@@ -493,6 +678,7 @@ export class FeatureFlagModel {
         }
         const flagMap = new Map(flags.map((flag) => [flag.name, flag]));
         const result = {};
+        const subjectMatchedFlagIds = await this.getSubjectMatchedFlagIds(subjects);
         for (const name of requestedNames) {
             const flag = flagMap.get(name);
             if (!flag) {
@@ -513,6 +699,8 @@ export class FeatureFlagModel {
                 user,
                 roles,
                 groups,
+                subjects,
+                subjectMatchedFlagIds,
             });
         }
         return result;
@@ -541,7 +729,14 @@ export class FeatureFlagModel {
 }
 const GROUP_TABLE = "flapjack.feature_flag_group";
 const GROUP_MEMBER_TABLE = "flapjack.feature_flag_group_member";
-const GROUP_COLUMNS = ["id", "name", "note", "created", "modified"];
+const GROUP_COLUMNS = [
+    "id",
+    "name",
+    "note",
+    "created",
+    "modified",
+    "archived",
+];
 function mapGroupRow(row) {
     return {
         id: row.id,
@@ -549,6 +744,7 @@ function mapGroupRow(row) {
         note: row.note ?? undefined,
         created: new Date(row.created),
         modified: new Date(row.modified),
+        archived: row.archived ? new Date(row.archived) : undefined,
     };
 }
 /**
@@ -625,8 +821,9 @@ export class FeatureFlagGroupModel {
      * }
      * ```
      */
-    async getById(id) {
-        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE} WHERE id = $1`;
+    async getById(id, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE} WHERE id = $1${filter}`;
         const res = await this.db.query(sql, [id]);
         return res.rows.length > 0 ? mapGroupRow(res.rows[0]) : null;
     }
@@ -641,8 +838,9 @@ export class FeatureFlagGroupModel {
      * const group = await model.getByName("billing_redesign");
      * ```
      */
-    async getByName(name) {
-        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE} WHERE name = $1`;
+    async getByName(name, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND archived IS NULL";
+        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE} WHERE name = $1${filter}`;
         const res = await this.db.query(sql, [name]);
         return res.rows.length > 0 ? mapGroupRow(res.rows[0]) : null;
     }
@@ -659,8 +857,9 @@ export class FeatureFlagGroupModel {
      * }
      * ```
      */
-    async list() {
-        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE} ORDER BY created DESC`;
+    async list({ includeArchived = false, } = {}) {
+        const filter = includeArchived ? "" : " WHERE archived IS NULL";
+        const sql = `SELECT ${GROUP_COLUMNS.join(", ")} FROM ${GROUP_TABLE}${filter} ORDER BY created DESC`;
         const res = await this.db.query(sql);
         return res.rows.map(mapGroupRow);
     }
@@ -702,11 +901,16 @@ export class FeatureFlagGroupModel {
         return res.rows.length > 0 ? mapGroupRow(res.rows[0]) : null;
     }
     /**
-     * Deletes a feature flag group and all its member relationships.
+     * Permanently deletes a feature flag group and all its member and subject
+     * relationships (via ON DELETE CASCADE).
      *
      * @param id - The group ID to delete
      * @returns true if deleted, false if not found
      *
+     * @remarks
+     * This is a hard delete that destroys all metadata. To hide a group while
+     * retaining its history for audit purposes, use {@link archive} instead.
+     *
      * @example
      * ```typescript
      * const deleted = await model.delete(1);
@@ -716,6 +920,31 @@ export class FeatureFlagGroupModel {
         const res = await this.db.query(`DELETE FROM ${GROUP_TABLE} WHERE id = $1`, [id]);
         return res.rowCount > 0;
     }
+    /**
+     * Archives (hides) a feature flag group while keeping the row for
+     * historical/audit purposes. Archived groups are excluded from normal reads
+     * and no longer contribute subject-based targeting. Member flags are left
+     * untouched and remain active; the membership and subject rows are kept for
+     * audit but become inert.
+     *
+     * @param id - The group ID to archive
+     * @returns The archived group, or null if it does not exist or is already archived
+     *
+     * @remarks
+     * Archiving is irreversible: there is intentionally no `unarchive` method.
+     * The `archived` timestamp is set once and never changed (a second call is a
+     * no-op that returns null). The group's name remains reserved permanently.
+     *
+     * @example
+     * ```typescript
+     * const archived = await model.archive(1);
+     * ```
+     */
+    async archive(id) {
+        const sql = `UPDATE ${GROUP_TABLE} SET archived = now() WHERE id = $1 AND archived IS NULL RETURNING ${GROUP_COLUMNS.join(", ")}`;
+        const res = await this.db.query(sql, [id]);
+        return res.rows.length > 0 ? mapGroupRow(res.rows[0]) : null;
+    }
     /**
      * Adds a feature flag to a group.
      *
@@ -777,12 +1006,13 @@ export class FeatureFlagGroupModel {
      * }
      * ```
      */
-    async getFeatureFlags(groupId) {
+    async getFeatureFlags(groupId, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND f.archived IS NULL";
         const sql = `
       SELECT ${COLUMNS.map((c) => `f.${c}`).join(", ")}
       FROM ${TABLE} f
       INNER JOIN ${GROUP_MEMBER_TABLE} gm ON f.id = gm.feature_flag_id
-      WHERE gm.group_id = $1
+      WHERE gm.group_id = $1${filter}
       ORDER BY f.created DESC
     `;
         const res = await this.db.query(sql, [groupId]);
@@ -799,17 +1029,69 @@ export class FeatureFlagGroupModel {
      * const groups = await model.getGroupsForFeatureFlag(5);
      * ```
      */
-    async getGroupsForFeatureFlag(featureFlagId) {
+    async getGroupsForFeatureFlag(featureFlagId, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND g.archived IS NULL";
         const sql = `
       SELECT ${GROUP_COLUMNS.map((c) => `g.${c}`).join(", ")}
       FROM ${GROUP_TABLE} g
       INNER JOIN ${GROUP_MEMBER_TABLE} gm ON g.id = gm.group_id
-      WHERE gm.feature_flag_id = $1
+      WHERE gm.feature_flag_id = $1${filter}
       ORDER BY g.created DESC
     `;
         const res = await this.db.query(sql, [featureFlagId]);
         return res.rows.map(mapGroupRow);
     }
+    /**
+     * Adds an external subject identifier to a feature flag group.
+     */
+    async addSubject(groupId, subject) {
+        try {
+            const sql = `INSERT INTO ${GROUP_SUBJECT_TABLE} (feature_flag_group_id, subject)
+        VALUES ($1, $2)`;
+            await this.db.query(sql, [groupId, subject]);
+            return true;
+        }
+        catch (err) {
+            if (err.code === "23505") {
+                return false;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Removes an external subject identifier from a feature flag group.
+     */
+    async removeSubject(groupId, subject) {
+        const sql = `DELETE FROM ${GROUP_SUBJECT_TABLE}
+      WHERE feature_flag_group_id = $1 AND subject = $2`;
+        const res = await this.db.query(sql, [groupId, subject]);
+        return res.rowCount > 0;
+    }
+    /**
+     * Gets all external subject identifiers associated with a feature flag group.
+     */
+    async getSubjects(groupId) {
+        const sql = `SELECT subject FROM ${GROUP_SUBJECT_TABLE}
+      WHERE feature_flag_group_id = $1
+      ORDER BY created DESC`;
+        const res = await this.db.query(sql, [groupId]);
+        return res.rows.map((row) => row.subject);
+    }
+    /**
+     * Gets all groups that are associated with a specific external subject identifier.
+     */
+    async getGroupsForSubject(subject, { includeArchived = false } = {}) {
+        const filter = includeArchived ? "" : " AND g.archived IS NULL";
+        const sql = `
+      SELECT ${GROUP_COLUMNS.map((c) => `g.${c}`).join(", ")}
+      FROM ${GROUP_TABLE} g
+      INNER JOIN ${GROUP_SUBJECT_TABLE} gs ON g.id = gs.feature_flag_group_id
+      WHERE gs.subject = $1${filter}
+      ORDER BY g.created DESC
+    `;
+        const res = await this.db.query(sql, [subject]);
+        return res.rows.map(mapGroupRow);
+    }
     /**
      * Updates all feature flags in a group with the same changes.
      *
@@ -858,10 +1140,10 @@ export class FeatureFlagGroupModel {
         }
         vals.push(groupId);
         const sql = `
-      UPDATE ${TABLE} 
+      UPDATE ${TABLE}
       SET ${updates.join(", ")}
-      WHERE id IN (
-        SELECT feature_flag_id 
+      WHERE archived IS NULL AND id IN (
+        SELECT feature_flag_id
         FROM ${GROUP_MEMBER_TABLE}
         WHERE group_id = $${paramIdx}
       )

package/dist/types.d.ts

@@ -16,6 +16,8 @@ export type FeatureFlag = {
     groups?: string[];
     /** List of specific user IDs that have this feature flag enabled */
     users?: string[];
+    /** List of tags for organizing flags (e.g. a release version like "release:1.5.0") */
+    tags?: string[];
     /** Description of where this flag is used and what it does */
     note?: string;
     /** Date when the feature flag was created */
@@ -24,6 +26,11 @@ export type FeatureFlag = {
     modified: Date;
     /** Optional expiration date for the feature flag */
     expires?: Date;
+    /**
+     * Date when the feature flag was archived (hidden). Set once and immutable;
+     * archiving is irreversible and the name remains reserved permanently.
+     */
+    archived?: Date;
 };
 /**
  * Called when a feature flag which has expired is used.
@@ -56,5 +63,10 @@ export type FeatureFlagGroup = {
     created: Date;
     /** Date when the group was last modified */
     modified: Date;
+    /**
+     * Date when the group was archived (hidden). Set once and immutable;
+     * archiving is irreversible and the name remains reserved permanently.
+     */
+    archived?: Date;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,mDAAmD;IACnD,QAAQ,EAAE,IAAI,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,EAC5C,IAAI,GACL,EAAE;IACD,IAAI,EAAE,WAAW,CAAC;CACnB,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,IAAI,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,IAAI,CAAC;IACd,mDAAmD;IACnD,QAAQ,EAAE,IAAI,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,EAC5C,IAAI,GACL,EAAE;IACD,IAAI,EAAE,WAAW,CAAC;CACnB,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,8BAA8B,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,IAAI,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,IAAI,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC"}