@farm.js/integration-utils 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Farm.js Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,11 @@
+# @farm.js/integration-utils
+
+Shared integration utilities for Farm.js
+
+Farm.js is currently in beta.
+
+```bash
+npm install @farm.js/integration-utils@beta
+```
+
+See the [Farm.js repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import type { FarmIntegrationConfigDefinition } from "@farm.js/core";
+type ConfigKey<TConfig> = Extract<keyof TConfig, string>;
+export interface ResolvedIntegrationConfigOptions<TConfig extends object> {
+    label: string;
+    env?: Partial<Record<ConfigKey<TConfig>, string | readonly string[]>>;
+    defaults?: Partial<TConfig>;
+    input?: Partial<TConfig>;
+    required?: readonly ConfigKey<TConfig>[];
+}
+export declare function integrationConfig<TConfig extends object>(options: ResolvedIntegrationConfigOptions<TConfig>): FarmIntegrationConfigDefinition<TConfig>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAErE,KAAK,SAAS,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,OAAO,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,gCAAgC,CAAC,OAAO,SAAS,MAAM;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,SAAS,MAAM,EACtD,OAAO,EAAE,gCAAgC,CAAC,OAAO,CAAC,GACjD,+BAA+B,CAAC,OAAO,CAAC,CAiC1C"}

package/dist/config.js

@@ -0,0 +1,37 @@
+export function integrationConfig(options) {
+    return {
+        env: options.env,
+        defaults: options.defaults,
+        input: options.input,
+        schema: {
+            safeParse(value) {
+                const data = (isObject(value) ? value : {});
+                const issues = options.required
+                    ?.filter((key) => isMissingConfigValue(data[key]))
+                    .map((key) => ({
+                    path: [key],
+                    code: "required",
+                    message: `${options.label} requires ${String(key)}.`,
+                })) ?? [];
+                if (issues.length > 0) {
+                    return {
+                        success: false,
+                        error: {
+                            issues,
+                        },
+                    };
+                }
+                return {
+                    success: true,
+                    data,
+                };
+            },
+        },
+    };
+}
+function isObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isMissingConfigValue(value) {
+    return value === undefined || value === null || value === "";
+}

package/dist/cookies.d.ts

@@ -0,0 +1,19 @@
+export interface ParsedCookie {
+    name: string;
+    value: string;
+}
+export interface RequestCookieOptions {
+    maxAge?: number;
+    httpOnly?: boolean;
+    sameSite?: "Lax" | "Strict" | "None";
+    path?: string;
+    secure?: boolean;
+    domain?: string;
+    expires?: Date;
+}
+export declare function parseCookieHeaderMap(header: string | null): Record<string, string>;
+export declare function parseCookieHeaderList(header: string | null): ParsedCookie[];
+export declare function getCookieValue(headers: Headers, name: string): string | null;
+export declare function createRequestCookie(name: string, value: string, request: Request, options?: RequestCookieOptions): string;
+export declare function clearRequestCookie(name: string, request: Request, options?: Omit<RequestCookieOptions, "maxAge">): string;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAelF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,EAAE,CAK3E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA4BR;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAM,GACjD,MAAM,CAKR"}

package/dist/cookies.js

@@ -0,0 +1,50 @@
+export function parseCookieHeaderMap(header) {
+    if (!header) {
+        return {};
+    }
+    return Object.fromEntries(header
+        .split(";")
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .map((part) => {
+        const [key, ...rest] = part.split("=");
+        return [key, decodeURIComponent(rest.join("="))];
+    }));
+}
+export function parseCookieHeaderList(header) {
+    return Object.entries(parseCookieHeaderMap(header)).map(([name, value]) => ({
+        name,
+        value,
+    }));
+}
+export function getCookieValue(headers, name) {
+    return parseCookieHeaderMap(headers.get("cookie"))[name] ?? null;
+}
+export function createRequestCookie(name, value, request, options = {}) {
+    const requestUrl = new URL(request.url);
+    const secure = options.secure ?? requestUrl.protocol === "https:";
+    const parts = [`${name}=${encodeURIComponent(value)}`, `Path=${options.path || "/"}`];
+    if (options.maxAge != null) {
+        parts.push(`Max-Age=${Math.max(0, Math.floor(options.maxAge))}`);
+    }
+    if (options.domain) {
+        parts.push(`Domain=${options.domain}`);
+    }
+    if (options.expires) {
+        parts.push(`Expires=${options.expires.toUTCString()}`);
+    }
+    if (options.httpOnly !== false) {
+        parts.push("HttpOnly");
+    }
+    if (secure) {
+        parts.push("Secure");
+    }
+    parts.push(`SameSite=${options.sameSite || "Lax"}`);
+    return parts.join("; ");
+}
+export function clearRequestCookie(name, request, options = {}) {
+    return createRequestCookie(name, "", request, {
+        ...options,
+        maxAge: 0,
+    });
+}

package/dist/html.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeHtml(value: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD"}

package/dist/html.js

@@ -0,0 +1,8 @@
+export function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { escapeHtml } from "./html.js";
+export { integrationConfig } from "./config.js";
+export { createAuthRouteIntegration, createPathInferredClientApi, methodNotAllowed, } from "./integration.js";
+export { createDocumentNavigationMatchers, normalizeMatchers } from "./matchers.js";
+export { clearRequestCookie, createRequestCookie, getCookieValue, parseCookieHeaderList, parseCookieHeaderMap, } from "./cookies.js";
+export { getOrigin, getReturnTo, resolveAppPath, resolveCallbackSettings, toAbsoluteUrl, withSearchParams, } from "./url.js";
+export { normalizeWebhookConfig } from "./webhooks.js";
+export type { FarmNormalizedWebhookDefinition, FarmWebhookAckResult, FarmWebhookConfig, FarmWebhookContext, FarmWebhookDefinition, FarmWebhookEvent, } from "./webhooks.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { escapeHtml } from "./html.js";
+export { integrationConfig } from "./config.js";
+export { createAuthRouteIntegration, createPathInferredClientApi, methodNotAllowed, } from "./integration.js";
+export { createDocumentNavigationMatchers, normalizeMatchers } from "./matchers.js";
+export { clearRequestCookie, createRequestCookie, getCookieValue, parseCookieHeaderList, parseCookieHeaderMap, } from "./cookies.js";
+export { getOrigin, getReturnTo, resolveAppPath, resolveCallbackSettings, toAbsoluteUrl, withSearchParams, } from "./url.js";
+export { normalizeWebhookConfig } from "./webhooks.js";

package/dist/integration.d.ts

@@ -0,0 +1,47 @@
+import { type FarmIntegrationHandlerContext, type FarmIntegrationAPIOperation, type FarmIntegrationLogger, type FarmIntegrationRouteMethod } from "@farm.js/core";
+export interface AuthRouteIntegrationConfig<TInstance> {
+    type: string;
+    instance: TInstance;
+    log?: FarmIntegrationLogger;
+    path: string;
+    methods: FarmIntegrationRouteMethod[];
+    handler: (request: Request, context: FarmIntegrationHandlerContext, instance: TInstance) => Promise<Response> | Response;
+}
+export declare function createAuthRouteIntegration<TInstance>(config: AuthRouteIntegrationConfig<TInstance>): import("@farm.js/core").DefinedIntegration<{
+    category: "auth";
+    type: string;
+    instance: TInstance;
+    log: FarmIntegrationLogger | undefined;
+    routes: {
+        path: string;
+        methods: FarmIntegrationRouteMethod[];
+        handler(request: Request, context: FarmIntegrationHandlerContext): Response | Promise<Response>;
+    }[];
+}>;
+export declare function methodNotAllowed(allow: readonly string[]): Response;
+export interface PathInferredClientOperation<TPath extends string = string, TOperation extends FarmIntegrationAPIOperation<any, any, any, any> = FarmIntegrationAPIOperation<any, any, any, any>, TLeafName extends string | undefined = undefined> {
+    path: TPath;
+    operation: TOperation;
+    leafName?: TLeafName;
+}
+type ReplaceLeafSegment<TPath extends string, TLeafName extends string | undefined = undefined> = TLeafName extends string ? TPath extends `${infer TBase}/${string}` ? `${TBase}/${TLeafName}` : TLeafName : TPath;
+type StripClientRoutePrefix<TPath extends string> = TPath extends `/api/${string}/${infer TRest}` ? TRest : TPath extends `/${string}/${infer TRest}` ? TRest : TPath extends `/${infer TRest}` ? TRest : TPath;
+type CamelCaseRouteSegment<TSegment extends string> = TSegment extends `${infer THead}-${infer TTail}` ? `${THead}${Capitalize<CamelCaseRouteSegment<TTail>>}` : TSegment;
+type NormalizeClientRouteSegmentType<TSegment extends string> = TSegment extends `[...${infer TName}]` ? TName : TSegment extends `[${infer TName}]` ? TName : TSegment extends `${infer TName}(${string}` ? TName : CamelCaseRouteSegment<TSegment>;
+type RouteNamespaceFromClientPath<TPath extends string, TOperation extends FarmIntegrationAPIOperation<any, any, any, any>> = TPath extends `${infer THead}/${infer TTail}` ? {
+    [TKey in NormalizeClientRouteSegmentType<THead>]: RouteNamespaceFromClientPath<TTail, TOperation>;
+} : {
+    [TKey in NormalizeClientRouteSegmentType<TPath>]: {
+        [TMethod in Lowercase<TOperation["method"] & string>]: TOperation;
+    };
+};
+type UnionToIntersection<TUnion> = (TUnion extends unknown ? (value: TUnion) => void : never) extends (value: infer TIntersection) => void ? TIntersection : never;
+type ExpandRecursively<TValue> = TValue extends (...args: any[]) => any ? TValue : TValue extends object ? {
+    [TKey in keyof TValue]: ExpandRecursively<TValue[TKey]>;
+} : TValue;
+type PathEntryToAPI<TEntry extends PathInferredClientOperation<string, any, any>> = TEntry extends PathInferredClientOperation<infer TPath extends string, infer TOperation extends FarmIntegrationAPIOperation<any, any, any, any>, infer TLeafName extends string | undefined> ? RouteNamespaceFromClientPath<StripClientRoutePrefix<ReplaceLeafSegment<TPath, TLeafName>>, TOperation> : never;
+type PathEntriesToAPI<TEntries extends readonly PathInferredClientOperation<string, any, any>[]> = ExpandRecursively<UnionToIntersection<PathEntryToAPI<TEntries[number]>>>;
+export type InferPathInferredClientAPI<TEntries extends readonly PathInferredClientOperation<string, any, any>[]> = PathEntriesToAPI<TEntries>;
+export declare function createPathInferredClientApi<const TEntries extends readonly PathInferredClientOperation<string, any, any>[]>(...entries: TEntries): InferPathInferredClientAPI<TEntries>;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

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

package/dist/integration.js

@@ -0,0 +1,87 @@
+import { defineIntegration, defineIntegrationAPI, } from "@farm.js/core";
+export function createAuthRouteIntegration(config) {
+    return defineIntegration({
+        category: "auth",
+        type: config.type,
+        instance: config.instance,
+        log: config.log,
+        routes: [
+            {
+                path: config.path,
+                methods: config.methods,
+                handler(request, context) {
+                    return config.handler(request, context, config.instance);
+                },
+            },
+        ],
+    });
+}
+export function methodNotAllowed(allow) {
+    return new Response("Method Not Allowed", {
+        status: 405,
+        headers: {
+            Allow: allow.join(", "),
+        },
+    });
+}
+function normalizeClientRouteSegment(segment) {
+    if (!segment) {
+        return segment;
+    }
+    if (segment.startsWith("[...") && segment.endsWith("]")) {
+        return segment.slice(4, -1);
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+        return segment.slice(1, -1);
+    }
+    const groupIndex = segment.indexOf("(");
+    if (groupIndex > 0) {
+        segment = segment.slice(0, groupIndex);
+    }
+    return segment.replace(/-([a-zA-Z0-9])/g, (_match, char) => char.toUpperCase());
+}
+function getClientSegmentsFromPath(path) {
+    const segments = path.split("/").filter(Boolean);
+    if (segments.length === 0) {
+        return ["index"];
+    }
+    const stripped = segments[0] === "api" && segments.length > 2
+        ? segments.slice(2)
+        : segments.length > 1
+            ? segments.slice(1)
+            : [segments[segments.length - 1]];
+    return stripped.map(normalizeClientRouteSegment).filter(Boolean);
+}
+function setClientOperation(target, segments, operation) {
+    const [head, ...tail] = segments;
+    if (!head) {
+        return;
+    }
+    if (tail.length === 0) {
+        const leaf = (target[head] || {});
+        leaf[operation.method.toLowerCase()] = {
+            ...operation,
+            path: operation.path,
+            __pathless: false,
+        };
+        target[head] = leaf;
+        return;
+    }
+    const branch = (target[head] || {});
+    target[head] = branch;
+    setClientOperation(branch, tail, operation);
+}
+export function createPathInferredClientApi(...entries) {
+    const api = {};
+    for (const entry of entries) {
+        const segments = getClientSegmentsFromPath(entry.path);
+        if (segments.length === 0) {
+            continue;
+        }
+        if (entry.leafName) {
+            segments[segments.length - 1] = entry.leafName;
+        }
+        setClientOperation(api, segments, entry.operation);
+    }
+    return defineIntegrationAPI(api);
+}

package/dist/matchers.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeMatchers(input?: string | string[]): string[];
+export declare function createDocumentNavigationMatchers(...paths: Array<string | undefined>): string[];
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAMrE;AAED,wBAAgB,gCAAgC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,EAAE,CAmB9F"}

package/dist/matchers.js

@@ -0,0 +1,22 @@
+export function normalizeMatchers(input) {
+    if (!input) {
+        return [];
+    }
+    return Array.isArray(input) ? input : [input];
+}
+export function createDocumentNavigationMatchers(...paths) {
+    const seen = new Set();
+    const matchers = [];
+    for (const path of paths) {
+        if (!path) {
+            continue;
+        }
+        const matcher = path.endsWith("(.*)") ? path : `${path}(.*)`;
+        if (seen.has(matcher)) {
+            continue;
+        }
+        seen.add(matcher);
+        matchers.push(matcher);
+    }
+    return matchers;
+}

package/dist/url.d.ts

@@ -0,0 +1,16 @@
+export interface ResolveCallbackSettingsInput {
+    callbackUrl?: string;
+    callbackPath?: string;
+    defaultPath: string;
+    label: string;
+}
+export declare function getOrigin(request: Request, configuredBaseUrl?: string): string;
+export declare function getReturnTo(rawValue: string | null | undefined, fallback?: string): string;
+export declare function toAbsoluteUrl(pathOrUrl: string, request: Request, configuredBaseUrl?: string): URL;
+export declare function withSearchParams(url: URL, params: Record<string, string | null | undefined>): URL;
+export declare function resolveAppPath(path: string | undefined, label: string): string | undefined;
+export declare function resolveCallbackSettings(input: ResolveCallbackSettingsInput, configuredBaseUrl?: string): {
+    callbackPath: string;
+    getCallbackUrl: (request: Request, params?: Record<string, string | null | undefined>) => string;
+};
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,SAAM,GAAG,MAAM,CAMvF;AAED,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,iBAAiB,CAAC,EAAE,MAAM,GACzB,GAAG,CAML;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,GAAG,CAUjG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU1F;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,EACnC,iBAAiB,CAAC,EAAE,MAAM,GACzB;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,KAAK,MAAM,CAAC;CAClG,CAkCA"}

package/dist/url.js

@@ -0,0 +1,62 @@
+export function getOrigin(request, configuredBaseUrl) {
+    return configuredBaseUrl || new URL(request.url).origin;
+}
+export function getReturnTo(rawValue, fallback = "/") {
+    if (!rawValue || !rawValue.startsWith("/")) {
+        return fallback;
+    }
+    return rawValue;
+}
+export function toAbsoluteUrl(pathOrUrl, request, configuredBaseUrl) {
+    try {
+        return new URL(pathOrUrl);
+    }
+    catch {
+        return new URL(pathOrUrl, getOrigin(request, configuredBaseUrl));
+    }
+}
+export function withSearchParams(url, params) {
+    for (const [key, value] of Object.entries(params)) {
+        if (value == null || value === "") {
+            continue;
+        }
+        url.searchParams.set(key, value);
+    }
+    return url;
+}
+export function resolveAppPath(path, label) {
+    if (!path) {
+        return undefined;
+    }
+    if (!path.startsWith("/")) {
+        throw new Error(`${label} must be a root-relative path.`);
+    }
+    return path;
+}
+export function resolveCallbackSettings(input, configuredBaseUrl) {
+    if (input.callbackUrl) {
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(input.callbackUrl);
+        }
+        catch {
+            throw new Error(`${input.label} callbackUrl must be an absolute URL.`);
+        }
+        if (input.callbackPath && input.callbackPath !== parsedUrl.pathname) {
+            throw new Error(`${input.label} callbackUrl pathname must match callbackPath when both are provided.`);
+        }
+        return {
+            callbackPath: input.callbackPath ?? parsedUrl.pathname,
+            getCallbackUrl(_request, params = {}) {
+                return withSearchParams(new URL(parsedUrl.toString()), params).toString();
+            },
+        };
+    }
+    const callbackPath = input.callbackPath ?? input.defaultPath;
+    return {
+        callbackPath,
+        getCallbackUrl(request, params = {}) {
+            return withSearchParams(new URL(callbackPath, getOrigin(request, configuredBaseUrl)), params).toString();
+        },
+    };
+}

package/dist/webhooks.d.ts

@@ -0,0 +1,43 @@
+import type { FarmIntegrationHandlerContext } from "@farm.js/core";
+export interface FarmWebhookEvent<TProvider extends string = string, TType extends string = string, TData = unknown, TRaw = unknown> {
+    provider: TProvider;
+    id: string;
+    type: TType;
+    data: TData;
+    raw: TRaw;
+}
+export interface FarmWebhookContext {
+    request: Request;
+    route: FarmIntegrationHandlerContext;
+    rawBody: string;
+    headers: Headers;
+    webhook: {
+        name: string;
+        path: string;
+    };
+}
+export interface FarmWebhookDefinition<TEvent extends FarmWebhookEvent = FarmWebhookEvent> {
+    path?: string;
+    secret?: string;
+    onEvent?: (event: TEvent, context: FarmWebhookContext) => void | Promise<void>;
+    onError?: (error: unknown, context: FarmWebhookContext) => Response | void | Promise<Response | void>;
+}
+export type FarmWebhookConfig<TEvent extends FarmWebhookEvent = FarmWebhookEvent> = FarmWebhookDefinition<TEvent> | Record<string, FarmWebhookDefinition<TEvent>>;
+export interface FarmNormalizedWebhookDefinition<TEvent extends FarmWebhookEvent = FarmWebhookEvent> extends FarmWebhookDefinition<TEvent> {
+    name: string;
+    path: string;
+}
+export interface FarmWebhookAckResult {
+    received: true;
+    provider: string;
+    webhook: string;
+    eventId: string;
+    type: string;
+}
+export declare function normalizeWebhookConfig<TEvent extends FarmWebhookEvent = FarmWebhookEvent>(input: {
+    webhooks?: FarmWebhookConfig<TEvent>;
+    defaultName: string;
+    defaultPath: string;
+    defaultSecret?: string;
+}): FarmNormalizedWebhookDefinition<TEvent>[];
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,WAAW,gBAAgB,CAC/B,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,KAAK,GAAG,OAAO,EACf,IAAI,GAAG,OAAO;IAEd,QAAQ,EAAE,SAAS,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,6BAA6B,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,gBAAgB,GAAG,gBAAgB;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,kBAAkB,KACxB,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,IAC5E,qBAAqB,CAAC,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AAElD,MAAM,WAAW,+BAA+B,CAC9C,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,CAClD,SAAQ,qBAAqB,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,IAAI,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAeD,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,gBAAgB,GAAG,gBAAgB,EAAE,KAAK,EAAE;IAChG,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,+BAA+B,CAAC,MAAM,CAAC,EAAE,CAgD5C"}

package/dist/webhooks.js

@@ -0,0 +1,46 @@
+function isWebhookDefinition(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    return "path" in value || "secret" in value || "onEvent" in value || "onError" in value;
+}
+export function normalizeWebhookConfig(input) {
+    const { webhooks, defaultName, defaultPath, defaultSecret } = input;
+    if (!webhooks) {
+        return [];
+    }
+    const normalized = isWebhookDefinition(webhooks)
+        ? [
+            {
+                ...webhooks,
+                name: defaultName,
+                path: webhooks.path ?? defaultPath,
+                secret: webhooks.secret ?? defaultSecret,
+            },
+        ]
+        : Object.entries(webhooks).map(([name, definition]) => {
+            if (!definition || typeof definition !== "object" || Array.isArray(definition)) {
+                throw new Error(`Webhook "${name}" must be configured with an object.`);
+            }
+            if (!definition.path || !definition.path.trim()) {
+                throw new Error(`Webhook "${name}" requires an explicit path when multiple webhooks are configured.`);
+            }
+            return {
+                ...definition,
+                name,
+                path: definition.path,
+                secret: definition.secret ?? defaultSecret,
+            };
+        });
+    const seenPaths = new Set();
+    for (const definition of normalized) {
+        if (!definition.path.trim()) {
+            throw new Error(`Webhook "${definition.name}" requires a non-empty path.`);
+        }
+        if (seenPaths.has(definition.path)) {
+            throw new Error(`Webhook path "${definition.path}" is duplicated in the integration config.`);
+        }
+        seenPaths.add(definition.path);
+    }
+    return normalized;
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@farm.js/integration-utils",
+  "version": "0.1.0-beta.0",
+  "description": "Shared integration utilities for Farm.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farming-labs/farm.js",
+    "directory": "packages/farm-integration-utils"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./cookies": {
+      "types": "./dist/cookies.d.ts",
+      "import": "./dist/cookies.js"
+    },
+    "./html": {
+      "types": "./dist/html.d.ts",
+      "import": "./dist/html.js"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.ts",
+      "import": "./dist/integration.js"
+    },
+    "./matchers": {
+      "types": "./dist/matchers.d.ts",
+      "import": "./dist/matchers.js"
+    },
+    "./url": {
+      "types": "./dist/url.d.ts",
+      "import": "./dist/url.js"
+    },
+    "./webhooks": {
+      "types": "./dist/webhooks.d.ts",
+      "import": "./dist/webhooks.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@farm.js/core": "0.1.0-beta.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "test": "echo 'No tests in this package'"
+  }
+}