@stigmer/react 0.0.71 → 0.0.73

package/invitation/InvitationRedemption.js.map

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

package/invitation/index.d.ts

@@ -0,0 +1,17 @@
+export { useOrgInvitations } from "./useOrgInvitations";
+export type { UseOrgInvitationsReturn } from "./useOrgInvitations";
+export { useCreateInvitation } from "./useCreateInvitation";
+export type { UseCreateInvitationReturn } from "./useCreateInvitation";
+export { useRevokeInvitation } from "./useRevokeInvitation";
+export type { UseRevokeInvitationReturn } from "./useRevokeInvitation";
+export { useInvitationPreview } from "./useInvitationPreview";
+export type { UseInvitationPreviewReturn } from "./useInvitationPreview";
+export { useRedeemInvitation } from "./useRedeemInvitation";
+export type { UseRedeemInvitationReturn } from "./useRedeemInvitation";
+export { InvitationCreatedAlert } from "./InvitationCreatedAlert";
+export type { InvitationCreatedAlertProps } from "./InvitationCreatedAlert";
+export { InvitationManager } from "./InvitationManager";
+export type { InvitationManagerProps } from "./InvitationManager";
+export { InvitationRedemption } from "./InvitationRedemption";
+export type { InvitationRedemptionProps } from "./InvitationRedemption";
+//# sourceMappingURL=index.d.ts.map

package/invitation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/invitation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/invitation/index.js

@@ -0,0 +1,9 @@
+export { useOrgInvitations } from "./useOrgInvitations";
+export { useCreateInvitation } from "./useCreateInvitation";
+export { useRevokeInvitation } from "./useRevokeInvitation";
+export { useInvitationPreview } from "./useInvitationPreview";
+export { useRedeemInvitation } from "./useRedeemInvitation";
+export { InvitationCreatedAlert } from "./InvitationCreatedAlert";
+export { InvitationManager } from "./InvitationManager";
+export { InvitationRedemption } from "./InvitationRedemption";
+//# sourceMappingURL=index.js.map

package/invitation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/invitation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/invitation/useCreateInvitation.d.ts

@@ -0,0 +1,52 @@
+import type { InvitationInput } from "@stigmer/sdk";
+import type { Invitation } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/api_pb";
+/** Return value of {@link useCreateInvitation}. */
+export interface UseCreateInvitationReturn {
+    /**
+     * Create an invitation link for an organization.
+     *
+     * Resolves with the server-created {@link Invitation} including the
+     * generated token in `status.token`. Callers must capture this token
+     * to construct the invite URL — it is always available via `get` and
+     * `listByOrg`, but surfacing it immediately after creation is the
+     * expected UX flow.
+     */
+    readonly create: (input: InvitationInput) => Promise<Invitation>;
+    /** `true` while the create request is in flight. */
+    readonly isCreating: boolean;
+    /** Error from the last failed create, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `invitation.create()` with loading and
+ * error state.
+ *
+ * Creates an invitation resource. The caller provides an
+ * {@link InvitationInput} with `name`, `org`, `role`, `expiresAt`,
+ * and optionally `maxRedemptions` and `label`.
+ *
+ * The returned {@link Invitation} contains the server-generated token
+ * in `status?.token`. Use this to build the invite URL:
+ * `https://<host>/invite/<token>`.
+ *
+ * Creating an invitation requires `can_grant_access` on the
+ * organization — typically limited to admins and owners.
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateInvitation();
+ *
+ * const invitation = await create({
+ *   name: "engineering-link",
+ *   org: "acme",
+ *   role: IamRole.VIEWER,
+ *   expiresAt: new Date(Date.now() + 30 * 86_400_000),
+ *   label: "Engineering team invite",
+ * });
+ * const inviteUrl = `${window.location.origin}/invite/${invitation.status?.token}`;
+ * ```
+ */
+export declare function useCreateInvitation(): UseCreateInvitationReturn;
+//# sourceMappingURL=useCreateInvitation.d.ts.map

package/invitation/useCreateInvitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateInvitation.d.ts","sourceRoot":"","sources":["../../src/invitation/useCreateInvitation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAItF,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACjE,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CAyB/D"}

package/invitation/useCreateInvitation.js

@@ -0,0 +1,55 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `invitation.create()` with loading and
+ * error state.
+ *
+ * Creates an invitation resource. The caller provides an
+ * {@link InvitationInput} with `name`, `org`, `role`, `expiresAt`,
+ * and optionally `maxRedemptions` and `label`.
+ *
+ * The returned {@link Invitation} contains the server-generated token
+ * in `status?.token`. Use this to build the invite URL:
+ * `https://<host>/invite/<token>`.
+ *
+ * Creating an invitation requires `can_grant_access` on the
+ * organization — typically limited to admins and owners.
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateInvitation();
+ *
+ * const invitation = await create({
+ *   name: "engineering-link",
+ *   org: "acme",
+ *   role: IamRole.VIEWER,
+ *   expiresAt: new Date(Date.now() + 30 * 86_400_000),
+ *   label: "Engineering team invite",
+ * });
+ * const inviteUrl = `${window.location.origin}/invite/${invitation.status?.token}`;
+ * ```
+ */
+export function useCreateInvitation() {
+    const stigmer = useStigmer();
+    const [isCreating, setIsCreating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const create = useCallback(async (input) => {
+        setIsCreating(true);
+        setError(null);
+        try {
+            return await stigmer.invitation.create(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsCreating(false);
+        }
+    }, [stigmer]);
+    return { create, isCreating, error, clearError };
+}
+//# sourceMappingURL=useCreateInvitation.js.map

package/invitation/useCreateInvitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateInvitation.js","sourceRoot":"","sources":["../../src/invitation/useCreateInvitation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAsB,EAAuB,EAAE;QACpD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/invitation/useInvitationPreview.d.ts

@@ -0,0 +1,51 @@
+import type { InvitationPreview } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/io_pb";
+/** Return value of {@link useInvitationPreview}. */
+export interface UseInvitationPreviewReturn {
+    /** The invitation preview, or `null` while loading or on error. */
+    readonly preview: InvitationPreview | null;
+    /** `true` while the initial fetch or a refetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the preview from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches an {@link InvitationPreview} by its
+ * shareable token.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the `token`
+ * changes, the previous in-flight request is discarded and a fresh
+ * fetch begins.
+ *
+ * This hook calls the `getByToken` endpoint, which is **public** —
+ * it requires no authentication. The server returns a safe projection
+ * containing only the information needed to render the invite
+ * acceptance page: organization name/logo, the role being offered,
+ * expiry, and whether the invitation is still valid.
+ *
+ * Check `preview.isValid` before offering the redemption action.
+ * When `false`, `preview.invalidReason` contains a human-readable
+ * explanation (expired, revoked, or fully redeemed).
+ *
+ * **Note**: Although authentication is not required by the server,
+ * the hook still requires a `StigmerProvider` ancestor because it
+ * needs the transport configuration (API base URL) to make the
+ * request.
+ *
+ * @param token - The invitation token from the invite URL, or `null`
+ *   to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { preview, isLoading, error } = useInvitationPreview(token);
+ *
+ * if (isLoading) return <Spinner />;
+ * if (!preview) return <NotFound />;
+ * if (!preview.isValid) return <Expired reason={preview.invalidReason} />;
+ *
+ * return <p>Join {preview.organizationName} as {preview.role}</p>;
+ * ```
+ */
+export declare function useInvitationPreview(token: string | null): UseInvitationPreviewReturn;
+//# sourceMappingURL=useInvitationPreview.d.ts.map

package/invitation/useInvitationPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInvitationPreview.d.ts","sourceRoot":"","sources":["../../src/invitation/useInvitationPreview.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAK5F,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,0BAA0B,CA0C5B"}

package/invitation/useInvitationPreview.js

@@ -0,0 +1,80 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { InvitationTokenInputSchema } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches an {@link InvitationPreview} by its
+ * shareable token.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the `token`
+ * changes, the previous in-flight request is discarded and a fresh
+ * fetch begins.
+ *
+ * This hook calls the `getByToken` endpoint, which is **public** —
+ * it requires no authentication. The server returns a safe projection
+ * containing only the information needed to render the invite
+ * acceptance page: organization name/logo, the role being offered,
+ * expiry, and whether the invitation is still valid.
+ *
+ * Check `preview.isValid` before offering the redemption action.
+ * When `false`, `preview.invalidReason` contains a human-readable
+ * explanation (expired, revoked, or fully redeemed).
+ *
+ * **Note**: Although authentication is not required by the server,
+ * the hook still requires a `StigmerProvider` ancestor because it
+ * needs the transport configuration (API base URL) to make the
+ * request.
+ *
+ * @param token - The invitation token from the invite URL, or `null`
+ *   to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { preview, isLoading, error } = useInvitationPreview(token);
+ *
+ * if (isLoading) return <Spinner />;
+ * if (!preview) return <NotFound />;
+ * if (!preview.isValid) return <Expired reason={preview.invalidReason} />;
+ *
+ * return <p>Join {preview.organizationName} as {preview.role}</p>;
+ * ```
+ */
+export function useInvitationPreview(token) {
+    const stigmer = useStigmer();
+    const [preview, setPreview] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!token) {
+            setPreview(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.invitation
+            .getByToken(create(InvitationTokenInputSchema, { token }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setPreview(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [token, stigmer, fetchKey]);
+    return { preview, isLoading, error, refetch };
+}
+//# sourceMappingURL=useInvitationPreview.js.map

package/invitation/useInvitationPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInvitationPreview.js","sourceRoot":"","sources":["../../src/invitation/useInvitationPreview.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAoB;IAEpB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAA2B,IAAI,CAAC,CAAC;IACvE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,UAAU;aACf,UAAU,CAAC,MAAM,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;aACzD,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,UAAU,CAAC,MAAM,CAAC,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE/B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/invitation/useOrgInvitations.d.ts

@@ -0,0 +1,36 @@
+import type { Invitation } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/api_pb";
+/** Return value of {@link useOrgInvitations}. */
+export interface UseOrgInvitationsReturn {
+    /** All invitations for the organization. Empty while loading or on error. */
+    readonly invitations: readonly Invitation[];
+    /** `true` while the initial fetch or a refetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the invitation list from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches all {@link Invitation} entries for an
+ * organization.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the `org` slug
+ * changes, the previous in-flight request is discarded and a fresh
+ * fetch begins. Call `refetch()` to re-query after mutations
+ * (create / revoke).
+ *
+ * Requires `can_view_access` permission on the organization —
+ * only admins and owners can list invitation links.
+ *
+ * @param org - Organization slug, or `null` to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { invitations, isLoading, error, refetch } = useOrgInvitations("acme");
+ *
+ * if (isLoading) return <Spinner />;
+ * invitations.map((inv) => inv.spec?.label);
+ * ```
+ */
+export declare function useOrgInvitations(org: string | null): UseOrgInvitationsReturn;
+//# sourceMappingURL=useOrgInvitations.d.ts.map

package/invitation/useOrgInvitations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOrgInvitations.d.ts","sourceRoot":"","sources":["../../src/invitation/useOrgInvitations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAKtF,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,uBAAuB,CA0CzB"}

package/invitation/useOrgInvitations.js

@@ -0,0 +1,65 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListInvitationsByOrgInputSchema } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches all {@link Invitation} entries for an
+ * organization.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the `org` slug
+ * changes, the previous in-flight request is discarded and a fresh
+ * fetch begins. Call `refetch()` to re-query after mutations
+ * (create / revoke).
+ *
+ * Requires `can_view_access` permission on the organization —
+ * only admins and owners can list invitation links.
+ *
+ * @param org - Organization slug, or `null` to skip fetching.
+ *
+ * @example
+ * ```tsx
+ * const { invitations, isLoading, error, refetch } = useOrgInvitations("acme");
+ *
+ * if (isLoading) return <Spinner />;
+ * invitations.map((inv) => inv.spec?.label);
+ * ```
+ */
+export function useOrgInvitations(org) {
+    const stigmer = useStigmer();
+    const [invitations, setInvitations] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org) {
+            setInvitations([]);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.invitation
+            .listByOrg(create(ListInvitationsByOrgInputSchema, { org }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setInvitations([...result.entries]);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, stigmer, fetchKey]);
+    return { invitations, isLoading, error, refetch };
+}
+//# sourceMappingURL=useOrgInvitations.js.map

package/invitation/useOrgInvitations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOrgInvitations.js","sourceRoot":"","sources":["../../src/invitation/useOrgInvitations.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB;IAElB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,cAAc,CAAC,EAAE,CAAC,CAAC;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,UAAU;aACf,SAAS,CAAC,MAAM,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;aAC3D,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE7B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/invitation/useRedeemInvitation.d.ts

@@ -0,0 +1,47 @@
+import type { Invitation } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/api_pb";
+/** Return value of {@link useRedeemInvitation}. */
+export interface UseRedeemInvitationReturn {
+    /**
+     * Redeem an invitation by its token.
+     *
+     * Creates an IAM policy granting the invitation's configured role
+     * to the authenticated user on the invitation's organization.
+     * Resolves with the updated {@link Invitation} so callers can
+     * access the organization and role information for post-redemption
+     * UI (e.g. "You've joined Acme as viewer").
+     */
+    readonly redeem: (token: string) => Promise<Invitation>;
+    /** `true` while the redeem request is in flight. */
+    readonly isRedeeming: boolean;
+    /** Error from the last failed redeem, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `invitation.redeem()` with loading and
+ * error state.
+ *
+ * Redeems an invitation by its shareable token. The server validates
+ * that the invitation is active, not expired, and not at its
+ * redemption limit, then creates an IAM policy granting the
+ * configured role to the authenticated user.
+ *
+ * The redeemer's identity is resolved from the authentication header
+ * — the token itself is the authorization mechanism (no FGA check
+ * on the invitation resource).
+ *
+ * Returns the updated {@link Invitation} including the incremented
+ * `status.redemptionCount` and the new entry in
+ * `status.redemptions`.
+ *
+ * @example
+ * ```tsx
+ * const { redeem, isRedeeming, error } = useRedeemInvitation();
+ *
+ * const invitation = await redeem("abc123...");
+ * // invitation.metadata?.org contains the org the user just joined
+ * ```
+ */
+export declare function useRedeemInvitation(): UseRedeemInvitationReturn;
+//# sourceMappingURL=useRedeemInvitation.d.ts.map

package/invitation/useRedeemInvitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRedeemInvitation.d.ts","sourceRoot":"","sources":["../../src/invitation/useRedeemInvitation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAKtF,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACxD,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CA2B/D"}

package/invitation/useRedeemInvitation.js

@@ -0,0 +1,53 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RedeemInvitationInputSchema } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `invitation.redeem()` with loading and
+ * error state.
+ *
+ * Redeems an invitation by its shareable token. The server validates
+ * that the invitation is active, not expired, and not at its
+ * redemption limit, then creates an IAM policy granting the
+ * configured role to the authenticated user.
+ *
+ * The redeemer's identity is resolved from the authentication header
+ * — the token itself is the authorization mechanism (no FGA check
+ * on the invitation resource).
+ *
+ * Returns the updated {@link Invitation} including the incremented
+ * `status.redemptionCount` and the new entry in
+ * `status.redemptions`.
+ *
+ * @example
+ * ```tsx
+ * const { redeem, isRedeeming, error } = useRedeemInvitation();
+ *
+ * const invitation = await redeem("abc123...");
+ * // invitation.metadata?.org contains the org the user just joined
+ * ```
+ */
+export function useRedeemInvitation() {
+    const stigmer = useStigmer();
+    const [isRedeeming, setIsRedeeming] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const redeem = useCallback(async (token) => {
+        setIsRedeeming(true);
+        setError(null);
+        try {
+            return await stigmer.invitation.redeem(create(RedeemInvitationInputSchema, { token }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsRedeeming(false);
+        }
+    }, [stigmer]);
+    return { redeem, isRedeeming, error, clearError };
+}
+//# sourceMappingURL=useRedeemInvitation.js.map

package/invitation/useRedeemInvitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRedeemInvitation.js","sourceRoot":"","sources":["../../src/invitation/useRedeemInvitation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAsB9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAa,EAAuB,EAAE;QAC3C,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CACpC,MAAM,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,CAC/C,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACpD,CAAC"}

package/invitation/useRevokeInvitation.d.ts

@@ -0,0 +1,35 @@
+import type { Invitation } from "@stigmer/protos/ai/stigmer/iam/invitation/v1/api_pb";
+/** Return value of {@link useRevokeInvitation}. */
+export interface UseRevokeInvitationReturn {
+    /** Revoke an invitation by its resource ID. Resolves with the updated resource for confirmation display. */
+    readonly revoke: (id: string) => Promise<Invitation>;
+    /** `true` while the revoke request is in flight. */
+    readonly isRevoking: boolean;
+    /** Error from the last failed revoke, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `invitation.revoke()` with loading and
+ * error state.
+ *
+ * Revokes an active invitation by its resource ID, setting its state
+ * to `revoked` and preventing further redemptions. The operation is
+ * idempotent — revoking an already-revoked invitation is a no-op
+ * that returns the unchanged resource.
+ *
+ * Returns the updated {@link Invitation} so callers can verify the
+ * new state. Call `refetch()` on the list hook after revocation to
+ * refresh the invitation list.
+ *
+ * @example
+ * ```tsx
+ * const { revoke, isRevoking, error } = useRevokeInvitation();
+ *
+ * await revoke("inv-abc123");
+ * refetch(); // refresh the invitation list
+ * ```
+ */
+export declare function useRevokeInvitation(): UseRevokeInvitationReturn;
+//# sourceMappingURL=useRevokeInvitation.d.ts.map

package/invitation/useRevokeInvitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRevokeInvitation.d.ts","sourceRoot":"","sources":["../../src/invitation/useRevokeInvitation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AAItF,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,4GAA4G;IAC5G,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CAyB/D"}

package/invitation/useRevokeInvitation.js

@@ -0,0 +1,47 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `invitation.revoke()` with loading and
+ * error state.
+ *
+ * Revokes an active invitation by its resource ID, setting its state
+ * to `revoked` and preventing further redemptions. The operation is
+ * idempotent — revoking an already-revoked invitation is a no-op
+ * that returns the unchanged resource.
+ *
+ * Returns the updated {@link Invitation} so callers can verify the
+ * new state. Call `refetch()` on the list hook after revocation to
+ * refresh the invitation list.
+ *
+ * @example
+ * ```tsx
+ * const { revoke, isRevoking, error } = useRevokeInvitation();
+ *
+ * await revoke("inv-abc123");
+ * refetch(); // refresh the invitation list
+ * ```
+ */
+export function useRevokeInvitation() {
+    const stigmer = useStigmer();
+    const [isRevoking, setIsRevoking] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const revoke = useCallback(async (id) => {
+        setIsRevoking(true);
+        setError(null);
+        try {
+            return await stigmer.invitation.revoke(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsRevoking(false);
+        }
+    }, [stigmer]);
+    return { revoke, isRevoking, error, clearError };
+}
+//# sourceMappingURL=useRevokeInvitation.js.map

package/invitation/useRevokeInvitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRevokeInvitation.js","sourceRoot":"","sources":["../../src/invitation/useRevokeInvitation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAc9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,EAAU,EAAuB,EAAE;QACxC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/library/detect-skill-package.d.ts

@@ -12,6 +12,7 @@ import type { ExecutionArtifact } from "@stigmer/protos/ai/stigmer/agentic/agent
  * - **Package detection** (`detectSkillPackage`): Skill packages (directory with SKILL.md) — pushed via `pushFromExecutionArtifact()`
  */
 export type SkillPackageDetection = {
+    /** Discriminant — `false` when no skill package was detected. */
     readonly detected: false;
 } | {
     /** Discriminant — always `true` when a skill package was detected. */

package/library/detect-skill-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-skill-package.d.ts","sourceRoot":"","sources":["../../src/library/detect-skill-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAI1G;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,GAC5B;IACE,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAMN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAKnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,MAAM,GACrB,qBAAqB,CAiBvB"}
+{"version":3,"file":"detect-skill-package.d.ts","sourceRoot":"","sources":["../../src/library/detect-skill-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAI1G;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B,GACD;IACE,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAMN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAKnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,MAAM,GACrB,qBAAqB,CAiBvB"}