@prismicio/plugin-kit 0.0.1

package/dist/hooks/slice-delete.d.ts

@@ -0,0 +1,26 @@
+import TypesInternal from "@prismicio/types-internal/lib/customtypes/index.js";
+import type { ExtendPluginSystemHook, PluginOptions, PluginHook } from "../types.js";
+/**
+ * Data provided to `slice:delete` hook handlers.
+ */
+export type SliceDeleteHookData = {
+    libraryID: string;
+    model: TypesInternal.SharedSlice;
+};
+/**
+ * Return value for `slice:delete` hook handlers.
+ */
+export type SliceDeleteHookReturnType = void;
+/**
+ * Base version of a `slice:delete` hook handler without plugin runner context.
+ *
+ * @internal
+ */
+export type SliceDeleteHookBase = PluginHook<SliceDeleteHookData, SliceDeleteHookReturnType>;
+/**
+ * Handler for the `slice:delete` hook. The hook is called when a Slice is
+ * deleted.
+ *
+ * @typeParam TPluginOptions - User-provided options for the hook's plugin.
+ */
+export type SliceDeleteHook<TPluginOptions extends PluginOptions = PluginOptions> = ExtendPluginSystemHook<SliceDeleteHookBase, TPluginOptions>;

package/dist/hooks/slice-read.d.ts

@@ -0,0 +1,32 @@
+import TypesInternal from "@prismicio/types-internal/lib/customtypes/index.js";
+import type { ExtendPluginSystemHook, PluginOptions, PluginHook } from "../types.js";
+/**
+ * Data provided to `slice:read` hook handlers.
+ */
+export type SliceReadHookData = {
+    libraryID: string;
+    sliceID: string;
+};
+/**
+ * Return value for `slice:read` hook handlers.
+ */
+export type SliceReadHookReturnType = {
+    model: TypesInternal.SharedSlice;
+};
+/**
+ * Base version of a `slice:read` hook handler without plugin runner context.
+ *
+ * @internal
+ */
+export type SliceReadHookBase = PluginHook<SliceReadHookData, SliceReadHookReturnType>;
+/**
+ * Handler for the `slice:read` hook. The hook is called when a Slice's model is
+ * needed.
+ *
+ * This hook is **required** to be implemented by adapters.
+ *
+ * This hook will only be called in adapters.
+ *
+ * @typeParam TPluginOptions - User-provided options for the hook's plugin.
+ */
+export type SliceReadHook<TPluginOptions extends PluginOptions = PluginOptions> = ExtendPluginSystemHook<SliceReadHookBase, TPluginOptions>;

package/dist/hooks/slice-rename.d.ts

@@ -0,0 +1,26 @@
+import TypesInternal from "@prismicio/types-internal/lib/customtypes/index.js";
+import type { ExtendPluginSystemHook, PluginOptions, PluginHook } from "../types.js";
+/**
+ * Data provided to `slice:rename` hook handlers.
+ */
+export type SliceRenameHookData = {
+    libraryID: string;
+    model: TypesInternal.SharedSlice;
+};
+/**
+ * Return value for `slice:rename` hook handlers.
+ */
+export type SliceRenameHookReturnType = void;
+/**
+ * Base version of a `slice:rename` hook handler without plugin runner context.
+ *
+ * @internal
+ */
+export type SliceRenameHookBase = PluginHook<SliceRenameHookData, SliceRenameHookReturnType>;
+/**
+ * Handler for the `slice:rename` hook. The hook is called when a Slice is
+ * renamed.
+ *
+ * @typeParam TPluginOptions - User-provided options for the hook's plugin.
+ */
+export type SliceRenameHook<TPluginOptions extends PluginOptions = PluginOptions> = ExtendPluginSystemHook<SliceRenameHookBase, TPluginOptions>;

package/dist/hooks/slice-update.d.ts

@@ -0,0 +1,29 @@
+import TypesInternal from "@prismicio/types-internal/lib/customtypes/index.js";
+import type { ExtendPluginSystemHook, PluginOptions, PluginHook } from "../types.js";
+/**
+ * Data provided to `slice:update` hook handlers.
+ */
+export type SliceUpdateHookData = {
+    libraryID: string;
+    model: TypesInternal.SharedSlice;
+};
+/**
+ * Return value for `slice:update` hook handlers.
+ */
+export type SliceUpdateHookReturnType = void;
+/**
+ * Base version of a `slice:update` hook handler without plugin runner context.
+ *
+ * @internal
+ */
+export type SliceUpdateHookBase = PluginHook<SliceUpdateHookData, SliceUpdateHookReturnType>;
+/**
+ * Handler for the `slice:update` hook. The hook is called when a Slice is
+ * updated.
+ *
+ * `slice:update` is not called the first time a Slice is saved. The
+ * `slice:create` hook is called instead.
+ *
+ * @typeParam TPluginOptions - User-provided options for the hook's plugin.
+ */
+export type SliceUpdateHook<TPluginOptions extends PluginOptions = PluginOptions> = ExtendPluginSystemHook<SliceUpdateHookBase, TPluginOptions>;

package/dist/hooks/sliceLibrary-read.d.ts

@@ -0,0 +1,27 @@
+import type { ExtendPluginSystemHook, PluginOptions, SliceLibrary, PluginHook } from "../types.js";
+/**
+ * Data provided to `slice-library:read` hook handlers.
+ */
+export type SliceLibraryReadHookData = {
+    libraryID: string;
+};
+/**
+ * Return value for `slice-library:read` hook handlers.
+ */
+export type SliceLibraryReadHookReturnType = SliceLibrary & {
+    sliceIDs: string[];
+};
+/**
+ * Base version of a `slice-library:read` hook handler without plugin runner
+ * context.
+ *
+ * @internal
+ */
+export type SliceLibraryReadHookBase = PluginHook<SliceLibraryReadHookData, SliceLibraryReadHookReturnType>;
+/**
+ * Handler for the `slice-library:read` hook. The hook is called when a Slice
+ * Library's metadata is needed.
+ *
+ * @typeParam TPluginOptions - User-provided options for the hook's plugin.
+ */
+export type SliceLibraryReadHook<TPluginOptions extends PluginOptions = PluginOptions> = ExtendPluginSystemHook<SliceLibraryReadHookBase, TPluginOptions>;

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { definePlugin } from "./definePlugin.js";
+export type { Plugin } from "./definePlugin.js";
+export type { PluginSystemActions, ReadAllSliceModelsActionArgs, ReadAllSliceModelsActionReturnType, ReadAllSliceModelsForLibraryActionArgs, } from "./createPluginSystemActions.js";
+export type { PluginSystemHelpers } from "./createPluginSystemHelpers.js";
+export type { PluginSystemContext } from "./createPluginSystemContext.js";
+export { PluginHookType } from "./types.js";
+export type { PluginOptions, PrismicProject, PrismicConfig, SliceLibrary, PluginHooks, PluginHookTypes, } from "./types.js";
+export { HookError } from "./lib/HookSystem.js";
+export { DecodeError } from "./lib/DecodeError.js";
+export type { SliceCreateHook, SliceCreateHookData, SliceCreateHookReturnType, } from "./hooks/slice-create.js";
+export type { SliceUpdateHook, SliceUpdateHookData, SliceUpdateHookReturnType, } from "./hooks/slice-update.js";
+export type { SliceRenameHook, SliceRenameHookData, SliceRenameHookReturnType, } from "./hooks/slice-rename.js";
+export type { SliceDeleteHook, SliceDeleteHookData, SliceDeleteHookReturnType, } from "./hooks/slice-delete.js";
+export type { SliceReadHook, SliceReadHookData, SliceReadHookReturnType, } from "./hooks/slice-read.js";
+export type { SliceLibraryReadHook, SliceLibraryReadHookData, SliceLibraryReadHookReturnType, } from "./hooks/sliceLibrary-read.js";
+export type { CustomTypeCreateHook, CustomTypeCreateHookData, CustomTypeCreateHookReturnType, } from "./hooks/customType-create.js";
+export type { CustomTypeUpdateHook, CustomTypeUpdateHookData, CustomTypeUpdateHookReturnType, } from "./hooks/customType-update.js";
+export type { CustomTypeRenameHook, CustomTypeRenameHookData, CustomTypeRenameHookReturnType, } from "./hooks/customType-rename.js";
+export type { CustomTypeDeleteHook, CustomTypeDeleteHookData, CustomTypeDeleteHookReturnType, } from "./hooks/customType-delete.js";
+export type { CustomTypeReadHook, CustomTypeReadHookData, CustomTypeReadHookReturnType, } from "./hooks/customType-read.js";
+export type { CustomTypeLibraryReadHook, CustomTypeLibraryReadHookData, CustomTypeLibraryReadHookReturnType, } from "./hooks/customTypeLibrary-read.js";
+export type { ProjectInitHook, ProjectInitHookData, ProjectInitHookReturnType, } from "./hooks/project-init.js";
+export { createPluginSystemRunner, PluginSystemRunner, REQUIRED_ADAPTER_HOOKS, } from "./createPluginSystemRunner.js";
+export type { CallHookReturnType } from "./lib/HookSystem.js";

package/dist/index.js

@@ -0,0 +1,15 @@
+import { definePlugin } from "./definePlugin.js";
+import { PluginHookType } from "./types.js";
+import { HookError } from "./lib/HookSystem.js";
+import { DecodeError } from "./lib/DecodeError.js";
+import { PluginSystemRunner, REQUIRED_ADAPTER_HOOKS, createPluginSystemRunner } from "./createPluginSystemRunner.js";
+export {
+  DecodeError,
+  HookError,
+  PluginHookType,
+  PluginSystemRunner,
+  REQUIRED_ADAPTER_HOOKS,
+  createPluginSystemRunner,
+  definePlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/lib/DecodeError.d.ts

@@ -0,0 +1,13 @@
+import * as z from "zod";
+type ZodIssue = z.ZodIssue;
+type DecodeErrorConstructorArgs<TInput = unknown> = {
+    input: TInput;
+    errors: ZodIssue[];
+};
+export declare class DecodeError<TInput = unknown> extends Error {
+    name: string;
+    input: TInput;
+    errors: string[];
+    constructor(args: DecodeErrorConstructorArgs<TInput>);
+}
+export {};

package/dist/lib/DecodeError.js

@@ -0,0 +1,21 @@
+function formatZodErrors(errors) {
+  return errors.map((err) => {
+    const path = err.path.length > 0 ? ` at ${err.path.join(".")}` : "";
+    return `${err.message}${path}`;
+  });
+}
+class DecodeError extends Error {
+  name = "DecodeError";
+  input;
+  errors;
+  constructor(args) {
+    const formattedErrors = formatZodErrors(args.errors);
+    super(formattedErrors.join(", "));
+    this.input = args.input;
+    this.errors = formattedErrors;
+  }
+}
+export {
+  DecodeError
+};
+//# sourceMappingURL=DecodeError.js.map

package/dist/lib/DecodeError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecodeError.js","sources":["../../../src/lib/DecodeError.ts"],"sourcesContent":["import * as z from \"zod\";\n\ntype ZodIssue = z.ZodIssue;\n\ntype DecodeErrorConstructorArgs<TInput = unknown> = {\n\tinput: TInput;\n\terrors: ZodIssue[];\n};\n\nfunction formatZodErrors(errors: ZodIssue[]): string[] {\n\treturn errors.map((err) => {\n\t\tconst path = err.path.length > 0 ? ` at ${err.path.join(\".\")}` : \"\";\n\n\t\treturn `${err.message}${path}`;\n\t});\n}\n\nexport class DecodeError<TInput = unknown> extends Error {\n\tname = \"DecodeError\";\n\tinput: TInput;\n\terrors: string[];\n\n\tconstructor(args: DecodeErrorConstructorArgs<TInput>) {\n\t\tconst formattedErrors = formatZodErrors(args.errors);\n\n\t\tsuper(formattedErrors.join(\", \"));\n\n\t\tthis.input = args.input;\n\t\tthis.errors = formattedErrors;\n\t}\n}\n"],"names":[],"mappings":"AASA,SAAS,gBAAgB,QAAkB;AAC1C,SAAO,OAAO,IAAI,CAAC,QAAO;AACzB,UAAM,OAAO,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK;AAEjE,WAAO,GAAG,IAAI,OAAO,GAAG,IAAI;AAAA,EAC7B,CAAC;AACF;AAEM,MAAO,oBAAsC,MAAK;AAAA,EACvD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EAEA,YAAY,MAAwC;AACnD,UAAM,kBAAkB,gBAAgB,KAAK,MAAM;AAEnD,UAAM,gBAAgB,KAAK,IAAI,CAAC;AAEhC,SAAK,QAAQ,KAAK;AAClB,SAAK,SAAS;AAAA,EACf;AACA;"}

package/dist/lib/HookSystem.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Extends a function arguments with extra ones.
+ */
+type FnWithExtraArgs<F extends (...args: any[]) => any, TExtraArgs extends any[] = any[]> = (...args: [...args: Parameters<F>, ...extraArgs: TExtraArgs]) => ReturnType<F>;
+/**
+ * Defines a hook handler.
+ */
+export type HookFn<TArgs extends any[] = any[], TReturn = any> = (...args: TArgs) => Promise<TReturn> | TReturn;
+/**
+ * Generic hook metadata.
+ */
+type HookMeta = Record<string, unknown>;
+/**
+ * Defines a hook, including its function handler and optional metadata.
+ */
+export type Hook<THookFn extends HookFn = HookFn, THookMeta extends HookMeta = HookMeta> = {
+    fn: THookFn;
+    meta?: THookMeta;
+};
+/**
+ * Represents a map of hook types to hook functions and metas.
+ */
+type Hooks = Record<string, Hook>;
+/**
+ * Builds hook meta arguments after hook meta requirements.
+ */
+type HookMetaArg<THookMeta extends Record<string, unknown> | undefined> = THookMeta extends Record<string, unknown> ? [meta: THookMeta] : [meta?: never];
+/**
+ * Defines the return type of the {@link HookSystem.callHook} functions.
+ *
+ * @internal
+ */
+export type CallHookReturnType<THookFn extends HookFn = HookFn> = Promise<{
+    data: Awaited<ReturnType<THookFn>>[];
+    errors: HookError[];
+}>;
+/**
+ * Defines the return type of the {@link HookSystem.createScope} functions.
+ *
+ * @internal
+ */
+export type CreateScopeReturnType<THooks extends Hooks = Record<string, {
+    fn: HookFn;
+}>, TExtraArgs extends unknown[] = never[]> = {
+    hook: <TType extends keyof THooks>(type: TType, hookFn: FnWithExtraArgs<THooks[TType]["fn"], TExtraArgs>, ...[meta]: HookMetaArg<THooks[TType]["meta"]>) => void;
+    unhook: HookSystem<{
+        [P in keyof THooks]: Omit<THooks[P], "fn"> & {
+            fn: FnWithExtraArgs<THooks[P]["fn"], TExtraArgs>;
+        };
+    }>["unhook"];
+};
+type RegisteredHookMeta = {
+    id: string;
+    type: string;
+    owner: string;
+    external?: HookFn;
+};
+/**
+ * Represents a registered hook.
+ */
+type RegisteredHook<THook extends Hook = Hook> = {
+    fn: THook["fn"];
+    meta: THook["meta"] extends Record<string, unknown> ? RegisteredHookMeta & THook["meta"] : RegisteredHookMeta;
+};
+export declare class HookError<TError = Error | unknown> extends Error {
+    type: string;
+    owner: string;
+    rawMeta: RegisteredHookMeta;
+    rawCause: TError;
+    constructor(meta: RegisteredHookMeta, cause: TError);
+}
+/**
+ * @internal
+ */
+export declare class HookSystem<THooks extends Hooks = Hooks> {
+    private _registeredHooks;
+    hook<TType extends keyof THooks>(owner: string, type: TType, hookFn: THooks[TType]["fn"], ...[meta]: HookMetaArg<THooks[TType]["meta"]>): void;
+    unhook<TType extends keyof THooks>(type: TType, hookFn: THooks[TType]["fn"]): void;
+    callHook<TType extends Extract<keyof THooks, string>>(typeOrTypeAndHookID: TType | {
+        type: TType;
+        hookID: string;
+    }, ...args: Parameters<THooks[TType]["fn"]>): CallHookReturnType<THooks[TType]["fn"]>;
+    /**
+     * Returns list of hooks for a given owner
+     */
+    hooksForOwner(owner: string): RegisteredHook<THooks[string]>[];
+    /**
+     * Returns list of hooks for a given type
+     */
+    hooksForType<TType extends keyof THooks>(type: TType): RegisteredHook<THooks[TType]>[];
+    createScope<TExtraArgs extends unknown[] = never[]>(owner: string, extraArgs: [...TExtraArgs]): CreateScopeReturnType<THooks, TExtraArgs>;
+}
+export {};

package/dist/lib/HookSystem.js

@@ -0,0 +1,121 @@
+class HookError extends Error {
+  type;
+  owner;
+  rawMeta;
+  rawCause;
+  constructor(meta, cause) {
+    super(`Error in \`${meta.owner}\` during \`${meta.type}\` hook: ${cause instanceof Error ? cause.message : String(cause)}`);
+    this.type = meta.type;
+    this.owner = meta.owner;
+    this.rawMeta = meta;
+    this.rawCause = cause;
+    this.cause = cause instanceof Error ? cause : void 0;
+  }
+}
+const uuid = () => {
+  return (++uuid.i).toString();
+};
+uuid.i = 0;
+class HookSystem {
+  _registeredHooks = {};
+  hook(owner, type, hookFn, ...[meta]) {
+    const registeredHook = {
+      fn: hookFn,
+      meta: {
+        ...meta,
+        owner,
+        type,
+        id: uuid()
+      }
+    };
+    const registeredHooksForType = this._registeredHooks[type];
+    if (registeredHooksForType) {
+      registeredHooksForType.push(registeredHook);
+    } else {
+      this._registeredHooks[type] = [registeredHook];
+    }
+  }
+  unhook(type, hookFn) {
+    this._registeredHooks[type] = this._registeredHooks[type]?.filter((registeredHook) => registeredHook.fn !== hookFn);
+  }
+  async callHook(typeOrTypeAndHookID, ...args) {
+    let hooks;
+    if (typeof typeOrTypeAndHookID === "string") {
+      hooks = this._registeredHooks[typeOrTypeAndHookID] ?? [];
+    } else {
+      const hookForID = this._registeredHooks[typeOrTypeAndHookID.type]?.find((hook) => hook.meta.id === typeOrTypeAndHookID.hookID);
+      if (hookForID) {
+        hooks = [hookForID];
+      } else {
+        throw new Error(`Hook of type \`${typeOrTypeAndHookID.type}\` with ID \`${typeOrTypeAndHookID.hookID}\` not found.`);
+      }
+    }
+    const promises = hooks.map(async (hook) => {
+      try {
+        return await hook.fn(...args);
+      } catch (error) {
+        throw new HookError(hook.meta, error);
+      }
+    });
+    const settledPromises = await Promise.allSettled(promises);
+    return settledPromises.reduce((acc, settledPromise) => {
+      if (settledPromise.status === "fulfilled") {
+        acc.data.push(settledPromise.value);
+      } else {
+        acc.errors.push(settledPromise.reason);
+      }
+      return acc;
+    }, { data: [], errors: [] });
+  }
+  /**
+   * Returns list of hooks for a given owner
+   */
+  hooksForOwner(owner) {
+    const hooks = [];
+    for (const hookType in this._registeredHooks) {
+      const registeredHooks = this._registeredHooks[hookType];
+      if (Array.isArray(registeredHooks)) {
+        for (const registeredHook of registeredHooks) {
+          if (registeredHook.meta.owner === owner) {
+            hooks.push(registeredHook);
+          }
+        }
+      }
+    }
+    return hooks;
+  }
+  /**
+   * Returns list of hooks for a given type
+   */
+  hooksForType(type) {
+    return this._registeredHooks[type] ?? [];
+  }
+  createScope(owner, extraArgs) {
+    return {
+      hook: (type, hookFn, ...[meta]) => {
+        const internalHook = (...args) => {
+          return hookFn(...args, ...extraArgs);
+        };
+        const resolvedMeta = {
+          ...meta,
+          external: hookFn
+        };
+        return this.hook(
+          owner,
+          type,
+          internalHook,
+          // @ts-expect-error - TypeScript fails to assert rest argument.
+          resolvedMeta
+        );
+      },
+      unhook: (type, hookFn) => {
+        this._registeredHooks[type] = this._registeredHooks[type]?.filter((registeredHook) => registeredHook.meta.external !== hookFn);
+      }
+    };
+  }
+}
+export {
+  HookError,
+  HookSystem
+};
+//# sourceMappingURL=HookSystem.js.map

package/dist/lib/HookSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookSystem.js","sources":["../../../src/lib/HookSystem.ts"],"sourcesContent":["/**\n * Extends a function arguments with extra ones.\n */\ntype FnWithExtraArgs<\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tF extends (...args: any[]) => any,\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tTExtraArgs extends any[] = any[],\n> = (\n\t...args: [...args: Parameters<F>, ...extraArgs: TExtraArgs]\n) => ReturnType<F>;\n\n/**\n * Defines a hook handler.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type HookFn<TArgs extends any[] = any[], TReturn = any> = (\n\t...args: TArgs\n) => Promise<TReturn> | TReturn;\n\n/**\n * Generic hook metadata.\n */\ntype HookMeta = Record<string, unknown>;\n\n/**\n * Defines a hook, including its function handler and optional metadata.\n */\nexport type Hook<\n\tTHookFn extends HookFn = HookFn,\n\tTHookMeta extends HookMeta = HookMeta,\n> = {\n\tfn: THookFn;\n\tmeta?: THookMeta;\n};\n\n/**\n * Represents a map of hook types to hook functions and metas.\n */\ntype Hooks = Record<string, Hook>;\n\n/**\n * Builds hook meta arguments after hook meta requirements.\n */\ntype HookMetaArg<THookMeta extends Record<string, unknown> | undefined> =\n\tTHookMeta extends Record<string, unknown>\n\t\t? [meta: THookMeta]\n\t\t: [meta?: never];\n\n/**\n * Defines the return type of the {@link HookSystem.callHook} functions.\n *\n * @internal\n */\nexport type CallHookReturnType<THookFn extends HookFn = HookFn> = Promise<{\n\tdata: Awaited<ReturnType<THookFn>>[];\n\terrors: HookError[];\n}>;\n\n/**\n * Defines the return type of the {@link HookSystem.createScope} functions.\n *\n * @internal\n */\nexport type CreateScopeReturnType<\n\tTHooks extends Hooks = Record<string, { fn: HookFn }>,\n\tTExtraArgs extends unknown[] = never[],\n> = {\n\thook: <TType extends keyof THooks>(\n\t\ttype: TType,\n\t\thookFn: FnWithExtraArgs<THooks[TType][\"fn\"], TExtraArgs>,\n\t\t...[meta]: HookMetaArg<THooks[TType][\"meta\"]>\n\t) => void;\n\tunhook: HookSystem<{\n\t\t[P in keyof THooks]: Omit<THooks[P], \"fn\"> & {\n\t\t\tfn: FnWithExtraArgs<THooks[P][\"fn\"], TExtraArgs>;\n\t\t};\n\t}>[\"unhook\"];\n};\n\ntype RegisteredHookMeta = {\n\tid: string;\n\ttype: string;\n\towner: string;\n\texternal?: HookFn;\n};\n\n/**\n * Represents a registered hook.\n */\ntype RegisteredHook<THook extends Hook = Hook> = {\n\tfn: THook[\"fn\"];\n\tmeta: THook[\"meta\"] extends Record<string, unknown>\n\t\t? RegisteredHookMeta & THook[\"meta\"]\n\t\t: RegisteredHookMeta;\n};\n\nexport class HookError<TError = Error | unknown> extends Error {\n\ttype: string;\n\towner: string;\n\trawMeta: RegisteredHookMeta;\n\trawCause: TError;\n\n\tconstructor(meta: RegisteredHookMeta, cause: TError) {\n\t\tsuper(\n\t\t\t`Error in \\`${meta.owner}\\` during \\`${meta.type}\\` hook: ${\n\t\t\t\tcause instanceof Error ? cause.message : String(cause)\n\t\t\t}`,\n\t\t);\n\n\t\tthis.type = meta.type;\n\t\tthis.owner = meta.owner;\n\t\tthis.rawMeta = meta;\n\t\tthis.rawCause = cause;\n\t\tthis.cause = cause instanceof Error ? cause : undefined;\n\t}\n}\n\nconst uuid = (): string => {\n\treturn (++uuid.i).toString();\n};\nuuid.i = 0;\n\n/**\n * @internal\n */\nexport class HookSystem<THooks extends Hooks = Hooks> {\n\tprivate _registeredHooks: {\n\t\t[K in keyof THooks]?: RegisteredHook<THooks[K]>[];\n\t} = {};\n\n\thook<TType extends keyof THooks>(\n\t\towner: string,\n\t\ttype: TType,\n\t\thookFn: THooks[TType][\"fn\"],\n\t\t...[meta]: HookMetaArg<THooks[TType][\"meta\"]>\n\t): void {\n\t\tconst registeredHook = {\n\t\t\tfn: hookFn,\n\t\t\tmeta: {\n\t\t\t\t...meta,\n\t\t\t\towner,\n\t\t\t\ttype,\n\t\t\t\tid: uuid(),\n\t\t\t},\n\t\t} as RegisteredHook<THooks[TType]>;\n\n\t\tconst registeredHooksForType = this._registeredHooks[type];\n\n\t\tif (registeredHooksForType) {\n\t\t\tregisteredHooksForType.push(registeredHook);\n\t\t} else {\n\t\t\tthis._registeredHooks[type] = [registeredHook];\n\t\t}\n\t}\n\n\tunhook<TType extends keyof THooks>(\n\t\ttype: TType,\n\t\thookFn: THooks[TType][\"fn\"],\n\t): void {\n\t\tthis._registeredHooks[type] = this._registeredHooks[type]?.filter(\n\t\t\t(registeredHook) => registeredHook.fn !== hookFn,\n\t\t);\n\t}\n\n\tasync callHook<TType extends Extract<keyof THooks, string>>(\n\t\ttypeOrTypeAndHookID: TType | { type: TType; hookID: string },\n\t\t...args: Parameters<THooks[TType][\"fn\"]>\n\t): CallHookReturnType<THooks[TType][\"fn\"]> {\n\t\tlet hooks: RegisteredHook<THooks[TType]>[];\n\n\t\tif (typeof typeOrTypeAndHookID === \"string\") {\n\t\t\thooks = this._registeredHooks[typeOrTypeAndHookID] ?? [];\n\t\t} else {\n\t\t\tconst hookForID = this._registeredHooks[typeOrTypeAndHookID.type]?.find(\n\t\t\t\t(hook) => hook.meta.id === typeOrTypeAndHookID.hookID,\n\t\t\t);\n\n\t\t\tif (hookForID) {\n\t\t\t\thooks = [hookForID];\n\t\t\t} else {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Hook of type \\`${typeOrTypeAndHookID.type}\\` with ID \\`${typeOrTypeAndHookID.hookID}\\` not found.`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tconst promises = hooks.map(async (hook) => {\n\t\t\ttry {\n\t\t\t\treturn await hook.fn(...args);\n\t\t\t} catch (error) {\n\t\t\t\tthrow new HookError(hook.meta, error);\n\t\t\t}\n\t\t});\n\n\t\tconst settledPromises = await Promise.allSettled(promises);\n\n\t\treturn settledPromises.reduce<{\n\t\t\tdata: Awaited<ReturnType<THooks[TType][\"fn\"]>>[];\n\t\t\terrors: HookError[];\n\t\t}>(\n\t\t\t(acc, settledPromise) => {\n\t\t\t\tif (settledPromise.status === \"fulfilled\") {\n\t\t\t\t\tacc.data.push(settledPromise.value);\n\t\t\t\t} else {\n\t\t\t\t\tacc.errors.push(settledPromise.reason);\n\t\t\t\t}\n\n\t\t\t\treturn acc;\n\t\t\t},\n\t\t\t{ data: [], errors: [] },\n\t\t);\n\t}\n\n\t/**\n\t * Returns list of hooks for a given owner\n\t */\n\thooksForOwner(owner: string): RegisteredHook<THooks[string]>[] {\n\t\tconst hooks: RegisteredHook<THooks[string]>[] = [];\n\n\t\tfor (const hookType in this._registeredHooks) {\n\t\t\tconst registeredHooks = this._registeredHooks[hookType];\n\n\t\t\tif (Array.isArray(registeredHooks)) {\n\t\t\t\tfor (const registeredHook of registeredHooks) {\n\t\t\t\t\tif (registeredHook.meta.owner === owner) {\n\t\t\t\t\t\thooks.push(registeredHook);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn hooks;\n\t}\n\n\t/**\n\t * Returns list of hooks for a given type\n\t */\n\thooksForType<TType extends keyof THooks>(\n\t\ttype: TType,\n\t): RegisteredHook<THooks[TType]>[] {\n\t\treturn this._registeredHooks[type] ?? [];\n\t}\n\n\tcreateScope<TExtraArgs extends unknown[] = never[]>(\n\t\towner: string,\n\t\textraArgs: [...TExtraArgs],\n\t): CreateScopeReturnType<THooks, TExtraArgs> {\n\t\treturn {\n\t\t\thook: (type, hookFn, ...[meta]) => {\n\t\t\t\tconst internalHook = ((\n\t\t\t\t\t...args: Parameters<THooks[typeof type][\"fn\"]>\n\t\t\t\t) => {\n\t\t\t\t\treturn hookFn(...args, ...extraArgs);\n\t\t\t\t}) as THooks[typeof type][\"fn\"];\n\n\t\t\t\tconst resolvedMeta = {\n\t\t\t\t\t...meta,\n\t\t\t\t\texternal: hookFn,\n\t\t\t\t} as HookMetaArg<THooks[typeof type][\"meta\"]>[0];\n\n\t\t\t\treturn this.hook(\n\t\t\t\t\towner,\n\t\t\t\t\ttype,\n\t\t\t\t\tinternalHook,\n\t\t\t\t\t// @ts-expect-error - TypeScript fails to assert rest argument.\n\t\t\t\t\tresolvedMeta,\n\t\t\t\t);\n\t\t\t},\n\t\t\tunhook: (type, hookFn) => {\n\t\t\t\tthis._registeredHooks[type] = this._registeredHooks[type]?.filter(\n\t\t\t\t\t(registeredHook) => registeredHook.meta.external !== hookFn,\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n}\n"],"names":[],"mappings":"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"}

package/dist/lib/decode.d.ts

@@ -0,0 +1,10 @@
+import * as z from "zod";
+import { DecodeError } from "./DecodeError.js";
+export type DecodeReturnType<A, _O, I> = {
+    value: A;
+    error?: never;
+} | {
+    value?: never;
+    error: DecodeError<I>;
+};
+export declare const decode: <A, O, I>(codec: z.ZodType<A>, input: I) => DecodeReturnType<A, O, I>;

package/dist/lib/decode.js

@@ -0,0 +1,16 @@
+import { DecodeError } from "./DecodeError.js";
+const decode = (codec, input) => {
+  const parsed = codec.safeParse(input);
+  if (parsed.success) {
+    return {
+      value: parsed.data
+    };
+  }
+  return {
+    error: new DecodeError({ input, errors: parsed.error.issues })
+  };
+};
+export {
+  decode
+};
+//# sourceMappingURL=decode.js.map

package/dist/lib/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sources":["../../../src/lib/decode.ts"],"sourcesContent":["import * as z from \"zod\";\n\nimport { DecodeError } from \"./DecodeError\";\n\nexport type DecodeReturnType<A, _O, I> =\n\t| {\n\t\t\tvalue: A;\n\t\t\terror?: never;\n\t  }\n\t| {\n\t\t\tvalue?: never;\n\t\t\terror: DecodeError<I>;\n\t  };\n\nexport const decode = <A, O, I>(\n\tcodec: z.ZodType<A>,\n\tinput: I,\n): DecodeReturnType<A, O, I> => {\n\tconst parsed = codec.safeParse(input);\n\n\tif (parsed.success) {\n\t\treturn {\n\t\t\tvalue: parsed.data,\n\t\t};\n\t}\n\n\treturn {\n\t\terror: new DecodeError({ input, errors: parsed.error.issues }),\n\t};\n};\n"],"names":[],"mappings":";AAcO,MAAM,SAAS,CACrB,OACA,UAC8B;AAC9B,QAAM,SAAS,MAAM,UAAU,KAAK;AAEpC,MAAI,OAAO,SAAS;AACnB,WAAO;AAAA,MACN,OAAO,OAAO;AAAA,IAAA;AAAA,EAEhB;AAEA,SAAO;AAAA,IACN,OAAO,IAAI,YAAY,EAAE,OAAO,QAAQ,OAAO,MAAM,OAAA,CAAQ;AAAA,EAAA;AAE/D;"}

package/dist/lib/decodePrismicConfig.d.ts

@@ -0,0 +1,3 @@
+import { PrismicConfig } from "../types.js";
+import { DecodeReturnType } from "./decode.js";
+export declare const decodePrismicConfig: (input: unknown) => DecodeReturnType<PrismicConfig, PrismicConfig, unknown>;

package/dist/lib/decodePrismicConfig.js

@@ -0,0 +1,22 @@
+import * as z from "zod";
+import { decode } from "./decode.js";
+const PrismicConfigPluginRegistrationSchema = z.union([
+  z.string(),
+  z.object({
+    resolve: z.string(),
+    options: z.record(z.string(), z.unknown()).optional()
+  })
+]);
+const PrismicConfigSchema = z.object({
+  repositoryName: z.string(),
+  adapter: PrismicConfigPluginRegistrationSchema,
+  apiEndpoint: z.string().optional(),
+  libraries: z.array(z.string()).optional()
+});
+const decodePrismicConfig = (input) => {
+  return decode(PrismicConfigSchema, input);
+};
+export {
+  decodePrismicConfig
+};
+//# sourceMappingURL=decodePrismicConfig.js.map

package/dist/lib/decodePrismicConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodePrismicConfig.js","sources":["../../../src/lib/decodePrismicConfig.ts"],"sourcesContent":["import * as z from \"zod\";\n\nimport { PrismicConfig } from \"../types\";\n\nimport { decode, DecodeReturnType } from \"./decode\";\n\nconst PrismicConfigPluginRegistrationSchema = z.union([\n\tz.string(),\n\tz.object({\n\t\tresolve: z.string(),\n\t\toptions: z.record(z.string(), z.unknown()).optional(),\n\t}),\n]);\n\nconst PrismicConfigSchema = z.object({\n\trepositoryName: z.string(),\n\tadapter: PrismicConfigPluginRegistrationSchema,\n\tapiEndpoint: z.string().optional(),\n\tlibraries: z.array(z.string()).optional(),\n});\n\nexport const decodePrismicConfig = (\n\tinput: unknown,\n): DecodeReturnType<PrismicConfig, PrismicConfig, unknown> => {\n\treturn decode(PrismicConfigSchema, input);\n};\n"],"names":[],"mappings":";;AAMA,MAAM,wCAAwC,EAAE,MAAM;AAAA,EACrD,EAAE,OAAA;AAAA,EACF,EAAE,OAAO;AAAA,IACR,SAAS,EAAE,OAAA;AAAA,IACX,SAAS,EAAE,OAAO,EAAE,OAAA,GAAU,EAAE,QAAA,CAAS,EAAE,SAAA;AAAA,EAAQ,CACnD;AACD,CAAA;AAED,MAAM,sBAAsB,EAAE,OAAO;AAAA,EACpC,gBAAgB,EAAE,OAAA;AAAA,EAClB,SAAS;AAAA,EACT,aAAa,EAAE,OAAA,EAAS,SAAA;AAAA,EACxB,WAAW,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,SAAA;AAC/B,CAAA;AAEM,MAAM,sBAAsB,CAClC,UAC4D;AAC5D,SAAO,OAAO,qBAAqB,KAAK;AACzC;"}