@baack-software/baack-ts-tasks 0.0.0-stage → 0.0.1

package/dist/react/ui/textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.js","sourceRoot":"","sources":["../../../src/react/ui/textarea.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,CAAA;AAEvB,SAAS,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAoC;IACzE,OAAO,CACL,gCACY,UAAU,EACpB,SAAS,EAAE,EAAE,CACX,whBAAwhB,EACxhB,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/react/ui/toggle-group.d.ts

@@ -0,0 +1,11 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+import { ToggleGroup as ToggleGroupPrimitive } from "radix-ui";
+import { toggleVariants } from "./toggle.tsx";
+declare function ToggleGroup({ className, variant, size, spacing, orientation, children, ...props }: React.ComponentProps<typeof ToggleGroupPrimitive.Root> & VariantProps<typeof toggleVariants> & {
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
+}): React.JSX.Element;
+declare function ToggleGroupItem({ className, children, variant, size, ...props }: React.ComponentProps<typeof ToggleGroupPrimitive.Item> & VariantProps<typeof toggleVariants>): React.JSX.Element;
+export { ToggleGroup, ToggleGroupItem };
+//# sourceMappingURL=toggle-group.d.ts.map

package/dist/react/ui/toggle-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-group.d.ts","sourceRoot":"","sources":["../../../src/react/ui/toggle-group.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAc7C,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAW,EACX,WAA0B,EAC1B,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,GACvD,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CACxC,qBAsBF;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,QAAQ,EACR,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,oBAAoB,CAAC,IAAI,CAAC,GACvD,YAAY,CAAC,OAAO,cAAc,CAAC,qBAsBpC;AAED,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAA"}

package/dist/react/ui/toggle-group.js

@@ -0,0 +1,25 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import {} from "class-variance-authority";
+import { cn } from "cn";
+import { ToggleGroup as ToggleGroupPrimitive } from "radix-ui";
+import { toggleVariants } from "./toggle.js";
+const ToggleGroupContext = React.createContext({
+    size: "default",
+    variant: "default",
+    spacing: 2,
+    orientation: "horizontal",
+});
+function ToggleGroup({ className, variant, size, spacing = 2, orientation = "horizontal", children, ...props }) {
+    return (_jsx(ToggleGroupPrimitive.Root, { "data-slot": "toggle-group", "data-variant": variant, "data-size": size, "data-spacing": spacing, "data-orientation": orientation, style: { "--gap": spacing }, className: cn("group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--gap))] rounded-lg data-[size=sm]:rounded-[min(var(--radius-md),10px)] data-vertical:flex-col data-vertical:items-stretch", className), ...props, children: _jsx(ToggleGroupContext.Provider, { value: { variant, size, spacing, orientation }, children: children }) }));
+}
+function ToggleGroupItem({ className, children, variant = "default", size = "default", ...props }) {
+    const context = React.useContext(ToggleGroupContext);
+    return (_jsx(ToggleGroupPrimitive.Item, { "data-slot": "toggle-group-item", "data-variant": context.variant || variant, "data-size": context.size || size, "data-spacing": context.spacing, className: cn("shrink-0 group-data-[spacing=0]/toggle-group:rounded-none group-data-[spacing=0]/toggle-group:px-2 focus:z-10 focus-visible:z-10 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-end]:pr-1.5 group-data-[spacing=0]/toggle-group:has-data-[icon=inline-start]:pl-1.5 group-data-horizontal/toggle-group:data-[spacing=0]:first:rounded-l-lg group-data-vertical/toggle-group:data-[spacing=0]:first:rounded-t-lg group-data-horizontal/toggle-group:data-[spacing=0]:last:rounded-r-lg group-data-vertical/toggle-group:data-[spacing=0]:last:rounded-b-lg group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:border-l-0 group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:border-t-0 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-l group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-t", toggleVariants({
+            variant: context.variant || variant,
+            size: context.size || size,
+        }), className), ...props, children: children }));
+}
+export { ToggleGroup, ToggleGroupItem };
+//# sourceMappingURL=toggle-group.js.map

package/dist/react/ui/toggle-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle-group.js","sourceRoot":"","sources":["../../../src/react/ui/toggle-group.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAqB,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,CAAA;AACvB,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAc,CAAA;AAE7C,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAK5C;IACA,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,YAAY;CAC1B,CAAC,CAAA;AAEF,SAAS,WAAW,CAAC,EACnB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAO,GAAG,CAAC,EACX,WAAW,GAAG,YAAY,EAC1B,QAAQ,EACR,GAAG,KAAK,EAKP;IACD,OAAO,CACL,KAAC,oBAAoB,CAAC,IAAI,iBACd,cAAc,kBACV,OAAO,eACV,IAAI,kBACD,OAAO,sBACH,WAAW,EAC7B,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAyB,EAClD,SAAS,EAAE,EAAE,CACX,mMAAmM,EACnM,SAAS,CACV,KACG,KAAK,YAET,KAAC,kBAAkB,CAAC,QAAQ,IAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,YAE7C,QAAQ,GACmB,GACJ,CAC7B,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,SAAS,EACT,QAAQ,EACR,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,GAAG,KAAK,EAE2B;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAEpD,OAAO,CACL,KAAC,oBAAoB,CAAC,IAAI,iBACd,mBAAmB,kBACf,OAAO,CAAC,OAAO,IAAI,OAAO,eAC7B,OAAO,CAAC,IAAI,IAAI,IAAI,kBACjB,OAAO,CAAC,OAAO,EAC7B,SAAS,EAAE,EAAE,CACX,k4BAAk4B,EACl4B,cAAc,CAAC;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;YACnC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;SAC3B,CAAC,EACF,SAAS,CACV,KACG,KAAK,YAER,QAAQ,GACiB,CAC7B,CAAA;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,CAAA"}

package/dist/react/ui/toggle.d.ts

@@ -0,0 +1,10 @@
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+import { Toggle as TogglePrimitive } from "radix-ui";
+declare const toggleVariants: (props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Toggle({ className, variant, size, ...props }: React.ComponentProps<typeof TogglePrimitive.Root> & VariantProps<typeof toggleVariants>): React.JSX.Element;
+export { Toggle, toggleVariants };
+//# sourceMappingURL=toggle.d.ts.map

package/dist/react/ui/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../../src/react/ui/toggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAEpD,QAAA,MAAM,cAAc;;;8EAoBnB,CAAA;AAED,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,eAAe,CAAC,IAAI,CAAC,GAClD,YAAY,CAAC,OAAO,cAAc,CAAC,qBAQpC;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}

package/dist/react/ui/toggle.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cva } from "class-variance-authority";
+import { cn } from "cn";
+import { Toggle as TogglePrimitive } from "radix-ui";
+const toggleVariants = cva("group/toggle inline-flex items-center justify-center gap-1 rounded-lg text-sm font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted data-[state=on]:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
+    variants: {
+        variant: {
+            default: "bg-transparent",
+            outline: "border border-input bg-transparent hover:bg-muted",
+        },
+        size: {
+            default: "h-8 min-w-8 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+            sm: "h-7 min-w-7 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
+            lg: "h-9 min-w-9 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+        },
+    },
+    defaultVariants: {
+        variant: "default",
+        size: "default",
+    },
+});
+function Toggle({ className, variant = "default", size = "default", ...props }) {
+    return (_jsx(TogglePrimitive.Root, { "data-slot": "toggle", className: cn(toggleVariants({ variant, size, className })), ...props }));
+}
+export { Toggle, toggleVariants };
+//# sourceMappingURL=toggle.js.map

package/dist/react/ui/toggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.js","sourceRoot":"","sources":["../../../src/react/ui/toggle.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,CAAA;AACvB,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAEpD,MAAM,cAAc,GAAG,GAAG,CACxB,qhBAAqhB,EACrhB;IACE,QAAQ,EAAE;QACR,OAAO,EAAE;YACP,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,mDAAmD;SAC7D;QACD,IAAI,EAAE;YACJ,OAAO,EACL,sFAAsF;YACxF,EAAE,EAAE,oLAAoL;YACxL,EAAE,EAAE,sFAAsF;SAC3F;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,SAAS;KAChB;CACF,CACF,CAAA;AAED,SAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAO,GAAG,SAAS,EACnB,IAAI,GAAG,SAAS,EAChB,GAAG,KAAK,EAE2B;IACnC,OAAO,CACL,KAAC,eAAe,CAAC,IAAI,iBACT,QAAQ,EAClB,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,KACvD,KAAK,GACT,CACH,CAAA;AACH,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAA"}

package/dist/refs.d.ts

@@ -0,0 +1,16 @@
+import type { Ref, RefLike } from './types.ts';
+/** The URN of a reference or a URN string. */
+export declare function urnOf(value: RefLike): string;
+/** A bare `{ urn }` reference, dropping any other fields of a read representation. */
+export declare function ref(value: RefLike): Ref;
+/** Bare references for a list, without duplicates, in their original order. */
+export declare function refs(values: readonly RefLike[] | null | undefined): Ref[];
+/** Whether two references point at the same representation. Absent references are equal to each other. */
+export declare function sameRef(a: RefLike | null | undefined, b: RefLike | null | undefined): boolean;
+/** Whether two lists hold the same references, ignoring order and duplicates. */
+export declare function sameRefs(a: readonly RefLike[] | null | undefined, b: readonly RefLike[] | null | undefined): boolean;
+/** A copy of `list` with `value` added, unless it is already there. */
+export declare function withRef(list: readonly RefLike[] | null | undefined, value: RefLike): Ref[];
+/** A copy of `list` without `value`. */
+export declare function withoutRef(list: readonly RefLike[] | null | undefined, value: RefLike): Ref[];
+//# sourceMappingURL=refs.d.ts.map

package/dist/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/C,8CAA8C;AAC9C,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,sFAAsF;AACtF,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAEvC;AAED,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,EAAE,CAWzE;AAED,0GAA0G;AAC1G,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG7F;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAIpH;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,EAAE,CAE1F;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,EAAE,CAG7F"}

package/dist/refs.js

@@ -0,0 +1,43 @@
+/** The URN of a reference or a URN string. */
+export function urnOf(value) {
+    return typeof value === 'string' ? value : value.urn;
+}
+/** A bare `{ urn }` reference, dropping any other fields of a read representation. */
+export function ref(value) {
+    return { urn: urnOf(value) };
+}
+/** Bare references for a list, without duplicates, in their original order. */
+export function refs(values) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values ?? []) {
+        const urn = urnOf(value);
+        if (!seen.has(urn)) {
+            seen.add(urn);
+            result.push({ urn });
+        }
+    }
+    return result;
+}
+/** Whether two references point at the same representation. Absent references are equal to each other. */
+export function sameRef(a, b) {
+    if (a == null || b == null)
+        return a == null && b == null;
+    return urnOf(a) === urnOf(b);
+}
+/** Whether two lists hold the same references, ignoring order and duplicates. */
+export function sameRefs(a, b) {
+    const left = new Set((a ?? []).map(urnOf));
+    const right = new Set((b ?? []).map(urnOf));
+    return left.size === right.size && [...left].every((urn) => right.has(urn));
+}
+/** A copy of `list` with `value` added, unless it is already there. */
+export function withRef(list, value) {
+    return refs([...(list ?? []), value]);
+}
+/** A copy of `list` without `value`. */
+export function withoutRef(list, value) {
+    const urn = urnOf(value);
+    return refs(list).filter((item) => item.urn !== urn);
+}
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAEA,8CAA8C;AAC9C,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;AACvD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,GAAG,CAAC,KAAc;IAChC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,IAAI,CAAC,MAA6C;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,OAAO,CAAC,CAA6B,EAAE,CAA6B;IAClF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;IAC1D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,CAAwC,EAAE,CAAwC;IACzG,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,OAAO,CAAC,IAA2C,EAAE,KAAc;IACjF,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAA2C,EAAE,KAAc;IACpF,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AACvD,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+/** Server-side helpers: receiving webhooks and automations. Needs a token that can write tasks, so never ship it to a browser. */
+export * from './webhooks.ts';
+export * from './recipes.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAClI,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+/** Server-side helpers: receiving webhooks and automations. Needs a token that can write tasks, so never ship it to a browser. */
+export * from "./webhooks.js";
+export * from "./recipes.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,kIAAkI;AAClI,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/server/recipes.d.ts

@@ -0,0 +1,39 @@
+import { type Task, type TaskStatus } from '@baack-software/baack-ts-client';
+import type { DraftInput } from '../draft.ts';
+import type { ChangeOptions, TaskClient } from '../task-client.ts';
+import type { RefLike } from '../types.ts';
+import { type WebhookEvent } from './webhooks.ts';
+/**
+ * Automations built from the client and helpers, for webhook handlers and scheduled jobs. Each takes what it needs
+ * and returns what it did, so callers can log it or notify someone.
+ */
+export interface WelcomeOptions extends ChangeOptions {
+    /** The company that owns the new task: usually yours, the one the webhook subscription belongs to. */
+    owner: RefLike;
+    /** The task to create, given the new company's URN. Default "Welcome your new customer", priority HIGH. */
+    task?: (company: string) => Omit<DraftInput, 'owner'>;
+}
+/**
+ * On a company being created, creates a task to welcome it, related to the new company. Returns the task, or
+ * `undefined` for any other event.
+ */
+export declare function welcomeNewCompany(event: WebhookEvent, tasks: TaskClient, { owner, task, ...options }: WelcomeOptions): Promise<Task | undefined>;
+export interface UnblockOptions extends ChangeOptions {
+    /** The status a task moves to once nothing blocks it. Default `PENDING`. */
+    status?: TaskStatus;
+}
+/**
+ * When `done` is finished, moves each task it was blocking out of `BLOCKED` if no other open task still blocks it.
+ * Reads the dependants and their other blockers fresh. Returns the tasks moved. Does nothing while `done` is open.
+ */
+export declare function unblockDependants(done: Task, tasks: TaskClient, { status, ...options }?: UnblockOptions): Promise<Task[]>;
+/**
+ * The webhook side of `unblockDependants`: on a task update, reads the task and unblocks its dependants once it is
+ * finished. Returns the tasks moved.
+ */
+export declare function unblockOnCompletion(event: WebhookEvent, tasks: TaskClient, options?: UnblockOptions): Promise<Task[]>;
+/** A company's open tasks past their due date, most urgent first. For a nightly job that notifies their assignees. */
+export declare function overdueTasks(tasks: TaskClient, owner: RefLike, now?: Date): Promise<Task[]>;
+/** Groups tasks by assignee URN, for one message per person. Unassigned tasks are under `''`. */
+export declare function byAssignee(tasks: readonly Task[]): Map<string, Task[]>;
+//# sourceMappingURL=recipes.d.ts.map

package/dist/server/recipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../src/server/recipes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjE;;;GAGG;AAEH,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,sGAAsG;IACtG,KAAK,EAAE,OAAO,CAAC;IACf,2GAA2G;IAC3G,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,cAAc,GAC1C,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAS3B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,EAAE,MAAkB,EAAE,GAAG,OAAO,EAAE,GAAE,cAAmB,GACtD,OAAO,CAAC,IAAI,EAAE,CAAC,CAiBjB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAK3H;AAED,sHAAsH;AACtH,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAG7G;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAOtE"}

package/dist/server/recipes.js

@@ -0,0 +1,81 @@
+import { isBaackApiError } from '@baack-software/baack-ts-client';
+import { openBlockers } from "../blockers.js";
+import { urnOf } from "../refs.js";
+import { byUrgency, isOpen, isOverdue } from "../tasks.js";
+import { webhookTarget } from "./webhooks.js";
+/**
+ * On a company being created, creates a task to welcome it, related to the new company. Returns the task, or
+ * `undefined` for any other event.
+ */
+export async function welcomeNewCompany(event, tasks, { owner, task, ...options }) {
+    if (event.trigger.subject !== 'COMPANY' || event.trigger.event !== 'CREATE')
+        return undefined;
+    const company = webhookTarget(event);
+    if (!company)
+        return undefined;
+    const fields = task?.(company) ?? { title: 'Welcome your new customer', priority: 'HIGH' };
+    return tasks.create({ owner, ...fields, associatedCompanies: [...(fields.associatedCompanies ?? []), { urn: company }] }, options);
+}
+/**
+ * When `done` is finished, moves each task it was blocking out of `BLOCKED` if no other open task still blocks it.
+ * Reads the dependants and their other blockers fresh. Returns the tasks moved. Does nothing while `done` is open.
+ */
+export async function unblockDependants(done, tasks, { status = 'PENDING', ...options } = {}) {
+    if (isOpen(done))
+        return [];
+    const moved = [];
+    for (const ref of done.blocking ?? []) {
+        const dependant = await readOrSkip(tasks, ref.urn);
+        if (!dependant || dependant.status !== 'BLOCKED')
+            continue;
+        const blockers = new Map([[done.urn, done]]);
+        for (const blocker of dependant.blockedBy ?? []) {
+            if (blockers.has(blocker.urn))
+                continue;
+            const read = await readOrSkip(tasks, blocker.urn);
+            if (read)
+                blockers.set(read.urn, read);
+        }
+        // A blocker that can't be read (deleted, or out of reach) counts as open, so nothing moves on a guess.
+        if (openBlockers(dependant, (urn) => blockers.get(urn)).length > 0)
+            continue;
+        moved.push(await tasks.setStatus(dependant, status, options));
+    }
+    return moved;
+}
+/**
+ * The webhook side of `unblockDependants`: on a task update, reads the task and unblocks its dependants once it is
+ * finished. Returns the tasks moved.
+ */
+export async function unblockOnCompletion(event, tasks, options) {
+    if (event.trigger.subject !== 'TASK' || event.trigger.event !== 'UPDATE')
+        return [];
+    const urn = webhookTarget(event);
+    const task = urn ? await readOrSkip(tasks, urn) : undefined;
+    return task ? unblockDependants(task, tasks, options) : [];
+}
+/** A company's open tasks past their due date, most urgent first. For a nightly job that notifies their assignees. */
+export async function overdueTasks(tasks, owner, now = new Date()) {
+    const { tasks: all } = await tasks.list({ owner, includeRelated: false });
+    return all.filter((task) => isOverdue(task, now)).sort(byUrgency);
+}
+/** Groups tasks by assignee URN, for one message per person. Unassigned tasks are under `''`. */
+export function byAssignee(tasks) {
+    const groups = new Map();
+    for (const task of tasks) {
+        const key = task.assignee ? urnOf(task.assignee) : '';
+        groups.set(key, [...(groups.get(key) ?? []), task]);
+    }
+    return groups;
+}
+async function readOrSkip(tasks, urn) {
+    try {
+        return await tasks.get(urn);
+    }
+    catch (error) {
+        if (isBaackApiError(error) && error.isNotFound)
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=recipes.js.map

package/dist/server/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/server/recipes.ts"],"names":[],"mappings":"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"}

package/dist/server/webhooks.d.ts

@@ -0,0 +1,135 @@
+import { type Task } from '@baack-software/baack-ts-client';
+import type { TaskClient } from '../task-client.ts';
+import type { Ref } from '../types.ts';
+/**
+ * Receiving Baack webhooks: verifying a delivery's signature, reading its event, and fetching the task it is about.
+ * Uses Web Crypto and the Fetch API types only, so it runs on Node 20+, Deno, Bun and edge runtimes.
+ *
+ * A delivery is a POST whose body is a webhook event, an envelope naming what changed (`trigger`) and where it is
+ * (`v1`), without the changed representation itself; read it from the API. Its headers:
+ *
+ * - `Signature`: base64 HMAC-SHA256, keyed with the subscription's secret, over the UTF-8 bytes of the parts
+ *   `Signed-Headers` lists, in that order and without separators. Today that is the body, then `Last-Modified`, then
+ *   `Idempotency-Key`.
+ * - `Last-Modified`: when the trigger happened, an ISO local date-time (UTC, without a zone, like other Baack
+ *   timestamps), signed as sent.
+ * - `Idempotency-Key`: the trigger's URN. Retries carry the same key, so handle each key once.
+ * - `X-Attempt-Number` and `X-Attempts-Remaining`: where a delivery is in its retries.
+ */
+/** Header names, lower case as the Fetch API's `Headers` and Node's `IncomingMessage` give them. */
+export declare const WEBHOOK_HEADERS: {
+    readonly signature: "signature";
+    readonly signedHeaders: "signed-headers";
+    readonly timestamp: "last-modified";
+    readonly idempotencyKey: "idempotency-key";
+    readonly attempt: "x-attempt-number";
+    readonly attemptsRemaining: "x-attempts-remaining";
+};
+/** What a delivery signs when it doesn't say, the order the API uses. */
+export declare const DEFAULT_SIGNED_PARTS: readonly ["body", "last-modified", "idempotency-key"];
+/** The kinds of representation a trigger can be about. */
+export type WebhookSubject = 'UNKNOWN' | 'ADDRESS' | 'API_CLIENT' | 'BEARER_TOKEN' | 'BOOLEAN_ITEM' | 'CLIENT_IDENTIFIER' | 'COMPANY' | 'DATETIME_ITEM' | 'DOUBLE_ITEM' | 'EMAIL' | 'ENTITY' | 'ENTITY_LIST' | 'GROUP' | 'GROUP_MEMBERSHIP' | 'IDENTITY' | 'JSON_ITEM' | 'LINK_ITEM' | 'REFERENCE_ITEM' | 'IMAGE_ITEM' | 'LATLONG_ITEM' | 'LONG_ITEM' | 'MARKDOWN_ITEM' | 'MESSAGE_THREAD' | 'MESSAGE_THREAD_NOTIFICATION' | 'MONEY_ITEM' | 'OAUTH_TOKEN' | 'PERMISSION' | 'PERSON' | 'PERSON_NAME' | 'PROJECT' | 'ROLE' | 'TASK' | 'TELEPHONE' | 'TEMPLATE_ITEM' | 'TEXT_ITEM' | 'THREAD_POST' | 'WEBHOOK_SUBSCRIPTION' | 'WORKFLOW';
+export type WebhookEventKind = 'CREATE' | 'UPDATE' | 'DELETE';
+/** What happened: a representation of `subject` was created, updated or deleted. */
+export interface WebhookTrigger {
+    urn: string;
+    owner?: Ref;
+    subject: WebhookSubject;
+    event: WebhookEventKind;
+    /** The URN of the representation that changed. */
+    targetUrn?: string;
+    timestamp?: string;
+}
+/** A webhook delivery's body. */
+export interface WebhookEvent {
+    trigger: WebhookTrigger;
+    subscription?: {
+        urn: string;
+        [field: string]: unknown;
+    };
+    /** Where the changed representation is. */
+    v1?: {
+        urn: string;
+        url?: string;
+    };
+}
+/** A delivery that passed verification. */
+export interface WebhookDelivery {
+    event: WebhookEvent;
+    /** The trigger's URN; the same on every retry of this delivery. */
+    idempotencyKey: string;
+    /** `Last-Modified`, as sent. */
+    timestamp: string;
+    attempt?: number;
+    attemptsRemaining?: number;
+}
+export type WebhookRejection = 'missing-signature' | 'missing-header' | 'unsigned-body' | 'bad-signature' | 'stale' | 'malformed-event';
+/** Thrown when a delivery can't be trusted or read. Answer 401 (or 400 for `malformed-event`) and don't act on it. */
+export declare class WebhookVerificationError extends Error {
+    readonly reason: WebhookRejection;
+    readonly name = "WebhookVerificationError";
+    constructor(reason: WebhookRejection, message: string);
+}
+/** Header lookups from the Fetch API's `Headers`, or a plain object such as Node's `req.headers`. */
+export type HeaderSource = Headers | Readonly<Record<string, string | readonly string[] | undefined>>;
+export interface VerifyOptions {
+    /**
+     * Refuse deliveries whose `Last-Modified` is older than this. Off by default: retries keep the trigger's time, so a
+     * late retry is still genuine. Use the idempotency key against replays instead.
+     */
+    maxAgeMs?: number;
+    now?: Date;
+}
+/**
+ * Checks a delivery's signature and returns its event. `body` must be the raw bytes or text as received: parsing and
+ * re-serialising the JSON changes the bytes and the signature won't match. Throws `WebhookVerificationError`.
+ */
+export declare function verifyWebhook(delivery: {
+    body: string | Uint8Array;
+    headers: HeaderSource;
+}, secret: string, options?: VerifyOptions): Promise<WebhookDelivery>;
+/** `verifyWebhook` for a Fetch API `Request`, reading its body. */
+export declare function verifyWebhookRequest(request: Request, secret: string, options?: VerifyOptions): Promise<WebhookDelivery>;
+/** Reads a delivery's body as a webhook event, checking the parts handlers rely on. Throws `WebhookVerificationError`. */
+export declare function parseWebhookEvent(body: string): WebhookEvent;
+/** The URN of the representation an event is about. */
+export declare function webhookTarget(event: WebhookEvent): string | undefined;
+/**
+ * Signs a delivery the way the API does, returning the headers to send with `body`. For tests and for replaying or
+ * simulating deliveries locally.
+ */
+export declare function signWebhook(body: string, secret: string, { timestamp, idempotencyKey }: {
+    timestamp: string;
+    idempotencyKey: string;
+}): Promise<Record<string, string>>;
+/**
+ * The task an event is about, read fresh, since events don't carry it. `null` when the task was deleted, by the event
+ * or since. Throws for events about anything but a task.
+ */
+export declare function taskFromWebhook(event: WebhookEvent, tasks: TaskClient): Promise<Task | null>;
+/** Remembers which deliveries were handled, so a retry isn't acted on twice. */
+export interface IdempotencyStore {
+    /** Records the key and returns true the first time it is seen, false after. */
+    claim(key: string): Promise<boolean> | boolean;
+    /** Forgets a key whose handling failed, so a retry runs it. */
+    release?(key: string): Promise<void> | void;
+}
+/**
+ * Keys held in memory for `ttlMs` (default a day). Enough for one process; use a shared store (a database row with
+ * a unique key, Redis `SET NX`) when several handle deliveries.
+ */
+export declare function memoryIdempotencyStore(ttlMs?: number): IdempotencyStore;
+export interface WebhookHandlerOptions {
+    secret: string;
+    /** Acts on a verified delivery seen for the first time. A throw answers 500, so the API retries. */
+    onEvent: (delivery: WebhookDelivery) => Promise<void> | void;
+    /** Default: in memory, per process. */
+    idempotency?: IdempotencyStore;
+    verify?: VerifyOptions;
+}
+/**
+ * A Fetch API handler (`(request) => Response`) for a webhook endpoint: verifies, skips repeats, and runs `onEvent`.
+ * Answers 401 to an untrusted delivery, 400 to an unreadable one, 200 once handled or already handled.
+ */
+export declare function webhookHandler(options: WebhookHandlerOptions): (request: Request) => Promise<Response>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/server/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/server/webhooks.ts"],"names":[],"mappings":"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"}