Initial commit

packages/core-consent/src/with-consent.ts

@@ -0,0 +1,27 @@
+import type { IConsent } from "./consent.interface";
+import type { ConsentChecked } from "@repo/core-shared/conformance";
+import { attachBrand } from "@repo/core-shared/conformance";
+
+export type { ConsentChecked };
+
+/**
+ * Use-case wrapper applied at DI bind time. Attaches the `__consentChecked`
+ * brand so the boot-time assertion can verify consent-gated use cases were
+ * bound through the consent-aware path.
+ *
+ * The forward closure keeps the brand on a fresh function so the original
+ * `fn` reference is not mutated — important when the same factory output is
+ * used elsewhere unwrapped (dev-seed paths, tests).
+ *
+ * Composition order (innermost to outermost):
+ *   withSpan → withCapture → withAudit → withAnalytics → withConsent → factory(deps)
+ */
+export function withConsent<Args extends unknown[], R>(
+  consent: IConsent,
+  fn: (...args: Args) => Promise<R>,
+): ConsentChecked<(...args: Args) => Promise<R>> {
+  void consent;
+  const wrapped: (...args: Args) => Promise<R> = (...args) => fn(...args);
+  attachBrand(wrapped, "__consentChecked");
+  return wrapped as ConsentChecked<(...args: Args) => Promise<R>>;
+}