@instructure/platform-institutional-tagging 8.0.2 → 8.0.4

package/dist/modals/CategoryModal/hooks/useEditCategoryForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditCategoryForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/CategoryModal/hooks/useEditCategoryForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,UAAU,yBAAyB;IACjC,QAAQ,EAAE,YAAY,CAAA;IACtB,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;CAC5D;AAED,UAAU,yBAAyB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C;AAED,eAAO,MAAM,mBAAmB,GAAI,0BAGjC,yBAAyB,KAAG,yBAiF9B,CAAA"}
+{"version":3,"file":"useEditCategoryForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/CategoryModal/hooks/useEditCategoryForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAQjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,UAAU,yBAAyB;IACjC,QAAQ,EAAE,YAAY,CAAA;IACtB,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;CAC5D;AAED,UAAU,yBAAyB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C;AAED,eAAO,MAAM,mBAAmB,GAAI,0BAGjC,yBAAyB,KAAG,yBAmF9B,CAAA"}

package/dist/modals/TagModal/hooks/useCreateTagForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateTagForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/TagModal/hooks/useCreateTagForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,UAAU,sBAAsB;IAC9B,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,mBAAmB,EAAE,WAAW,EAAE,CAAA;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAA;IACnC,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxD;AAED,eAAO,MAAM,gBAAgB,GAAI,mCAG9B,sBAAsB,KAAG,sBAmH3B,CAAA"}
+{"version":3,"file":"useCreateTagForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/TagModal/hooks/useCreateTagForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOjD,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,UAAU,sBAAsB;IAC9B,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,mBAAmB,EAAE,WAAW,EAAE,CAAA;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAA;IACnC,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxD;AAED,eAAO,MAAM,gBAAgB,GAAI,mCAG9B,sBAAsB,KAAG,sBA8H3B,CAAA"}

package/dist/modals/TagModal/hooks/useEditTagForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditTagForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/TagModal/hooks/useEditTagForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,UAAU,oBAAoB;IAC5B,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;CAC5D;AAED,UAAU,oBAAoB;IAC5B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,mBAAmB,EAAE,WAAW,EAAE,CAAA;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAA;IACnC,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxD;AAED,eAAO,MAAM,cAAc,GAAI,oBAAoB,oBAAoB,KAAG,oBAiGzE,CAAA"}
+{"version":3,"file":"useEditTagForm.d.ts","sourceRoot":"","sources":["../../../../src/modals/TagModal/hooks/useEditTagForm.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAMjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,UAAU,oBAAoB;IAC5B,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;CAC5D;AAED,UAAU,oBAAoB;IAC5B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,mBAAmB,EAAE,WAAW,EAAE,CAAA;IAClC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,kBAAkB,EAAE,OAAO,CAAA;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAA;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,oBAAoB,EAAE,WAAW,EAAE,CAAA;IACnC,mBAAmB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3C,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvC,iBAAiB,EAAE,MAAM,CAAA;IACzB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,uBAAuB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,8BAA8B,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxD;AAED,eAAO,MAAM,cAAc,GAAI,oBAAoB,oBAAoB,KAAG,oBAsIzE,CAAA"}

package/dist/query/__tests__/map.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=map.test.d.ts.map

package/dist/query/__tests__/map.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.test.d.ts","sourceRoot":"","sources":["../../../src/query/__tests__/map.test.ts"],"names":[],"mappings":""}

package/dist/query/events.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The taxonomy of cache-affecting mutations in this package, mapped to the
+ * context each one needs to resolve its invalidation set.
+ *
+ * Association events are split by *view side* on purpose. `AccountTags` (tag
+ * side) and `UserProfileTags` (user side) are separate exported entry points
+ * that Canvas mounts in different features / on different pages — separate page
+ * loads, so their query caches are never live at the same time. A tag-side write
+ * therefore never needs to touch user-side reads and vice versa; splitting lets
+ * each side invalidate only what its own page can display.
+ *
+ * An empty context (`{}`) means the event invalidates only bare-prefix roots and
+ * needs no entity ids; `useCacheInvalidator` lets callers omit the ctx argument
+ * for those events.
+ */
+export interface InvalidationEventContext {
+    'category.created': Record<string, never>;
+    'category.updated': Record<string, never>;
+    'category.archived': {
+        categoryId: string;
+    };
+    'category.restored': {
+        categoryId: string;
+    };
+    /** `categoryCreated` when a brand-new category was created inline as part of tag creation. */
+    'tag.created': {
+        categoryId: string;
+        categoryCreated?: boolean;
+    };
+    /**
+     * `previousCategoryId` when an edit moved the tag between categories;
+     * `categoryCreated` when a brand-new category was created inline during the edit.
+     */
+    'tag.updated': {
+        tagId: string;
+        categoryId: string;
+        previousCategoryId?: string;
+        categoryCreated?: boolean;
+    };
+    'tag.archived': {
+        tagId: string;
+        categoryId: string;
+    };
+    /** `newCategoryId` when a restore also moves the tag to a different category. */
+    'tag.restored': {
+        tagId: string;
+        categoryId: string;
+        newCategoryId?: string;
+    };
+    'tag.moved': {
+        fromCategoryId: string;
+        toCategoryId: string;
+    };
+    /** `categoryId` scopes the tag-cache eviction to one category; omit to fall back to all. */
+    'people.addedToTag': {
+        tagId: string;
+        categoryId?: string;
+    };
+    'people.removedFromTag': {
+        tagId: string;
+        categoryId?: string;
+    };
+    'tags.addedToUser': {
+        userId: string;
+    };
+    'tags.removedFromUser': {
+        userId: string;
+    };
+}
+export type InvalidationEvent = keyof InvalidationEventContext;
+//# sourceMappingURL=events.d.ts.map

package/dist/query/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/query/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACzC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACzC,mBAAmB,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,mBAAmB,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,8FAA8F;IAC9F,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAChE;;;OAGG;IACH,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;IACD,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,iFAAiF;IACjF,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7E,WAAW,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D,4FAA4F;IAC5F,mBAAmB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3D,uBAAuB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,kBAAkB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,sBAAsB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,wBAAwB,CAAA"}

package/dist/query/index.d.ts

@@ -0,0 +1,5 @@
+export { queryKeys } from './keys';
+export { useCacheInvalidator, type InvalidateOptions } from './useCacheInvalidator';
+export type { InvalidationEvent, InvalidationEventContext } from './events';
+export type { CacheOp } from './ops';
+//# sourceMappingURL=index.d.ts.map

package/dist/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACnF,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAC3E,YAAY,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA"}

package/dist/query/keys.d.ts

@@ -0,0 +1,83 @@
+import { InstitutionalTagUsersSortInput, InstitutionalTagWorkflowState } from '@instructure/platform-graphql-types';
+import { WorkflowState } from '../types/state';
+/**
+ * Single source of truth for every TanStack Query key used in this package.
+ *
+ * Each namespace exposes two shapes:
+ *   - `root` (and scoped prefixes like `inCategory`/`forTag`): the bare prefix
+ *     used for INVALIDATION. TanStack matches keys by array prefix, so
+ *     `['tags']` matches every `['tags', categoryId, cursor, workflowState]`
+ *     variant and `['userTags', userId]` matches `['userTags', userId, accountId]`.
+ *     This is why invalidation never needs `accountId` — the prefix matches
+ *     regardless.
+ *   - `list`/`of`: the FULL key used by a read hook's `useQuery`.
+ *
+ * The full-key builders reproduce the exact array shapes the hooks used before
+ * this factory existed, so migrating a read hook to the factory is
+ * behavior-preserving (same cache identity). Standardizing the `accountId`
+ * position across keys is a deliberately deferred follow-up.
+ */
+export declare const queryKeys: {
+    /** Paginated category list on the AccountTags screen. */
+    readonly categories: {
+        readonly root: readonly ["categories"];
+        readonly list: (cursor: string | null, searchTerm: string, workflowState: WorkflowState) => readonly ["categories", string | null, string, WorkflowState];
+    };
+    /** Full active-category list (autocompletes); account-scoped. */
+    readonly allCategories: {
+        readonly root: readonly ["allCategories"];
+        readonly of: (accountId: string) => readonly ["allCategories", string];
+    };
+    /** Per-category paginated tag list. */
+    readonly tags: {
+        readonly root: readonly ["tags"];
+        readonly inCategory: (categoryId: string) => readonly ["tags", string];
+        readonly list: (categoryId: string, cursor: string | null, workflowState?: InstitutionalTagWorkflowState) => readonly ["tags", string, string | null, InstitutionalTagWorkflowState | undefined];
+    };
+    /** Flat list of active tag names (duplicate-suggestion combobox); account-scoped. */
+    readonly allTagNames: {
+        readonly root: readonly ["allTagNames"];
+        readonly of: (accountId: string) => readonly ["allTagNames", string];
+    };
+    /** All active tags grouped by category (AssignTagsModal); account-scoped. */
+    readonly allActiveTags: {
+        readonly root: readonly ["allActiveTags"];
+        readonly of: (accountId: string) => readonly ["allActiveTags", string];
+    };
+    /** Users tagged with a single tag (TagDetail people table). */
+    readonly tagUsers: {
+        readonly root: readonly ["tagUsers"];
+        readonly forTag: (tagId: string) => readonly ["tagUsers", string];
+        readonly list: (tagId: string, cursor: string | null, sort?: InstitutionalTagUsersSortInput, searchTerm?: string) => readonly ["tagUsers", string, string | null, InstitutionalTagUsersSortInput | undefined, string | undefined];
+    };
+    /** The already-tagged user-id set used to exclude users in AddPeopleModal. */
+    readonly tagExistingUsers: {
+        readonly root: readonly ["tagExistingUsers"];
+        readonly forTag: (tagId: string) => readonly ["tagExistingUsers", string];
+    };
+    /** Tags applied to a single user (UserProfileTags); account-scoped. */
+    readonly userTags: {
+        readonly root: readonly ["userTags"];
+        readonly forUser: (userId: string) => readonly ["userTags", string];
+        readonly of: (userId: string, accountId: string) => readonly ["userTags", string, string];
+    };
+    /** Account users for the AddPeopleModal manual search; account-scoped. */
+    readonly accountUsers: {
+        readonly root: readonly ["accountUsers"];
+        readonly list: (accountId: string, searchTerm: string, cursor: string | null) => readonly ["accountUsers", string, string, string | null];
+    };
+};
+/**
+ * The union of every key shape the factory can produce — each namespace's
+ * `root` tuple plus every builder's return tuple. `inv()`/`remove()` accept only
+ * this, so a hand-written array literal in the invalidation map (e.g. a typo'd
+ * `['tag']`) fails to type-check and every invalidation is forced through the
+ * factory. Keeps the factory the single source of truth at compile time, not
+ * just by convention.
+ */
+type ExtractQueryKey<T> = T extends readonly unknown[] ? T : T extends (...args: never[]) => infer R ? R extends readonly unknown[] ? R : never : T extends object ? {
+    [K in keyof T]: ExtractQueryKey<T[K]>;
+}[keyof T] : never;
+export type FactoryQueryKey = ExtractQueryKey<typeof queryKeys>;
+export {};
+//# sourceMappingURL=keys.d.ts.map

package/dist/query/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/query/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;IACpB,yDAAyD;;;gCAGxC,MAAM,GAAG,IAAI,cAAc,MAAM,iBAAiB,aAAa;;IAGhF,iEAAiE;;;iCAG/C,MAAM;;IAExB,uCAAuC;;;0CAGZ,MAAM;oCAEjB,MAAM,UACV,MAAM,GAAG,IAAI,kBACL,6BAA6B;;IAGjD,qFAAqF;;;iCAGnE,MAAM;;IAExB,6EAA6E;;;iCAG3D,MAAM;;IAExB,+DAA+D;;;iCAG7C,MAAM;+BAEb,MAAM,UACL,MAAM,GAAG,IAAI,SACd,8BAA8B,eACxB,MAAM;;IAGvB,8EAA8E;;;iCAG5D,MAAM;;IAExB,uEAAuE;;;mCAGnD,MAAM;8BACX,MAAM,aAAa,MAAM;;IAExC,0EAA0E;;;mCAGtD,MAAM,cAAc,MAAM,UAAU,MAAM,GAAG,IAAI;;CAG7D,CAAA;AAEV;;;;;;;GAOG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,OAAO,EAAE,GAClD,CAAC,GACD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC,GACrC,CAAC,SAAS,SAAS,OAAO,EAAE,GAC1B,CAAC,GACD,KAAK,GACP,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,GAClD,KAAK,CAAA;AAEb,MAAM,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/query/map.d.ts

@@ -0,0 +1,20 @@
+import { InvalidationEvent, InvalidationEventContext } from './events';
+import { CacheOp } from './ops';
+/**
+ * THE invalidation contract. For each mutation event, the exact set of cache
+ * operations that keeps every dependent read coherent. This is the single place
+ * a developer edits when a mutation's data footprint changes — hooks just fire
+ * the event.
+ *
+ * `inv()` ops use TanStack's default `'active'` refetch scope: they refresh the
+ * consumers mounted right now and mark everything else stale. Canvas runs these
+ * components under the `@instructure/platform-query` client (`staleTime: 0` +
+ * `refetchOnMount: true`), so an unmounted consumer refetches when it remounts —
+ * the map only needs to name the reads each mutation affects.
+ */
+type InvalidationMap = {
+    [E in InvalidationEvent]: (ctx: InvalidationEventContext[E]) => readonly CacheOp[];
+};
+export declare const invalidationMap: InvalidationMap;
+export {};
+//# sourceMappingURL=map.d.ts.map

package/dist/query/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/query/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAC3E,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,OAAO,CAAA;AAGhD;;;;;;;;;;;GAWG;AACH,KAAK,eAAe,GAAG;KACpB,CAAC,IAAI,iBAAiB,GAAG,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,SAAS,OAAO,EAAE;CACnF,CAAA;AAwED,eAAO,MAAM,eAAe,EAAE,eA+C7B,CAAA"}

package/dist/query/ops.d.ts

@@ -0,0 +1,41 @@
+import { FactoryQueryKey } from './keys';
+/**
+ * A single cache mutation the invalidator applies after a mutation settles.
+ *
+ * - `invalidate`: mark the (prefix-matched) key stale; the invalidator uses
+ *   TanStack's default `'active'` refetch scope, so currently-mounted consumers
+ *   refetch immediately and everything else is left stale to refetch on its next
+ *   mount. That is sufficient because Canvas runs these components under the
+ *   `@instructure/platform-query` client (`staleTime: 0` + `refetchOnMount: true`),
+ *   so an unmounted consumer (a closed modal, another screen) always refetches
+ *   when it remounts. The map therefore encodes *which reads a mutation affects*;
+ *   its job is to refresh the views that are on screen right now.
+ * - `reset`: discard the cached data for every prefix match, then refetch the
+ *   mounted ones. For keys where a *stale cached page* would be wrong rather than
+ *   merely dated — in practice the cursor-paginated per-category tag list (see
+ *   `perCategoryTagCache` in map.ts).
+ */
+export type CacheOp = {
+    readonly kind: 'invalidate';
+    readonly queryKey: FactoryQueryKey;
+} | {
+    readonly kind: 'reset';
+    readonly queryKey: FactoryQueryKey;
+};
+/** Invalidate a key (prefix match). Accepts only factory-produced keys. */
+export declare const inv: (queryKey: FactoryQueryKey) => CacheOp;
+/**
+ * Drop the cached data behind a key (prefix match) and refetch whatever is
+ * mounted. Use only where a stale cached page is *incorrect* rather than merely
+ * dated — the per-category tag list, where replaying a cursor captured before the
+ * write duplicates or drops a tag across pages.
+ *
+ * Backed by `resetQueries`, deliberately not `removeQueries`. Both drop the cached
+ * pages, but `removeQueries` detaches a mounted observer from the cache without
+ * refetching it, leaving an on-screen tag list showing the pre-mutation tags
+ * (covered in staleness.regression.test.tsx). `resetQueries` clears the same
+ * entries and refetches the active ones, so the eviction cannot silently cost us
+ * the refresh.
+ */
+export declare const reset: (queryKey: FactoryQueryKey) => CacheOp;
+//# sourceMappingURL=ops.d.ts.map

package/dist/query/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../src/query/ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAA;AAElE,2EAA2E;AAC3E,eAAO,MAAM,GAAG,GAAI,UAAU,eAAe,KAAG,OAA6C,CAAA;AAE7F;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,eAAe,KAAG,OAAwC,CAAA"}

package/dist/query/useCacheInvalidator.d.ts

@@ -0,0 +1,49 @@
+import { InvalidationEvent, InvalidationEventContext } from './events';
+type EmptyCtx = Record<string, never>;
+export interface InvalidateOptions {
+    /**
+     * Await the invalidation + refetch pass. Needed where downstream cache
+     * ordering depends on it (e.g. `useMoveTag` must finish evicting/refetching
+     * before the drag UI settles). Defaults to fire-and-forget, matching the
+     * behavior of the hooks this replaces.
+     */
+    await?: boolean;
+}
+/**
+ * Arguments after the event name. Events whose context is empty (`{}`) may omit
+ * the ctx argument entirely; all others must supply it. `options` is always
+ * optional.
+ */
+type InvalidateArgs<E extends InvalidationEvent> = InvalidationEventContext[E] extends EmptyCtx ? [ctx?: InvalidationEventContext[E], options?: InvalidateOptions] : [ctx: InvalidationEventContext[E], options?: InvalidateOptions];
+/**
+ * The single entry point mutations use to keep the cache coherent. Resolves the
+ * declarative {@link invalidationMap} for the given event and applies each cache
+ * operation — `invalidateQueries` (TanStack's default `'active'` scope: refetch
+ * the mounted consumers now, mark the rest stale so they refetch on next mount)
+ * or `resetQueries`.
+ *
+ *   const invalidate = useCacheInvalidator()
+ *   invalidate('tag.archived', { tagId, categoryId })            // fire-and-forget
+ *   await invalidate('tag.moved', { fromCategoryId, toCategoryId }, { await: true })
+ *
+ * Fire the event on a mutation's **error** paths too, not just onSuccess:
+ *
+ * - `onError` (transport failure / rejection) — **always**. The outcome is
+ *   unknown; the write may have committed before the connection dropped, so the
+ *   cache cannot be trusted.
+ * - payload `errors` (the server answered and refused) — only when the refusal
+ *   itself proves the cache disagrees with the server: "already archived",
+ *   "already active", "association not found". A plain validation refusal on a
+ *   create/update ("has already been taken", "can't be blank") changed nothing
+ *   server-side, so there is nothing to resync.
+ *
+ * Inverse pairs have to match on all three paths. A symmetric `invalidationMap`
+ * does not help if only one half of a pair fires the event — that just moves the
+ * drift this layer exists to remove up to the call sites.
+ *
+ * For an empty-context event, ctx is optional; to await one, pass `undefined`
+ * explicitly for ctx: `await invalidate('category.created', undefined, { await: true })`.
+ */
+export declare const useCacheInvalidator: () => <E extends InvalidationEvent>(event: E, ...args: InvalidateArgs<E>) => Promise<void>;
+export {};
+//# sourceMappingURL=useCacheInvalidator.d.ts.map

package/dist/query/useCacheInvalidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheInvalidator.d.ts","sourceRoot":"","sources":["../../src/query/useCacheInvalidator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AAI3E,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAErC,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;GAIG;AACH,KAAK,cAAc,CAAC,CAAC,SAAS,iBAAiB,IAAI,wBAAwB,CAAC,CAAC,CAAC,SAAS,QAAQ,GAC3F,CAAC,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,GAChE,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,mBAAmB,SAI3B,CAAC,SAAS,iBAAiB,SAAS,CAAC,WAAW,cAAc,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,IAAI,CA2BpF,CAAA"}

package/locales/en.json

@@ -55,6 +55,7 @@
   "restoreTagCategoryRequired": "Select a category to restore the tag.",
   "restoreTagFailed": "Failed to restore tag.",
   "saveCategoryFailed": "Failed to save category. Please try again.",
+  "saveTagFailed": "Failed to save tag. Please try again.",
   "tagAlreadyExists": "This tag name already exists.",
   "tagDescriptionRequired": "Tag description is required.",
   "tagMoveConflict": "A tag with this name already exists in the selected category.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instructure/platform-institutional-tagging",
-  "version": "8.0.2",
+  "version": "8.0.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -49,7 +49,7 @@
     "@tanstack/react-query": "^5.0.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
-    "@instructure/platform-instui-bindings": "0.6.3",
+    "@instructure/platform-instui-bindings": "0.6.4",
     "@instructure/platform-provider": "0.5.2"
   },
   "devDependencies": {
@@ -99,7 +99,7 @@
     "@instructure/ui-truncate-text": "11.6.0",
     "@instructure/ui-utils": "11.6.0",
     "@instructure/platform-graphql-types": "0.2.0",
-    "@instructure/platform-instui-bindings": "0.6.3"
+    "@instructure/platform-instui-bindings": "0.6.4"
   },
   "dependencies": {
     "@dnd-kit/core": "^6.3.1",