@junobuild/functions 0.0.3 → 0.0.5

package/dist/browser/index.js

@@ -1,2 +1,2 @@
-function c(o){return o}function p(o){return o}import{jsonReplacer as r,jsonReviver as i}from"@dfinity/utils";var l=o=>JSON.parse(__juno_satellite_datastore_raw_data_to_text(o),i),x=o=>__juno_satellite_datastore_raw_data_from_text(JSON.stringify(o,r));import{jsonReplacer as s}from"@dfinity/utils";var t=o=>{let n=o.map(e=>typeof e=="object"?JSON.stringify(e,s):e).join(" ");globalThis.__ic_cdk_print(n)};globalThis.console={info(...o){t(o)},log(...o){t(o)},warn(...o){t(o)},error(...o){t(o)}};export{l as decodeDocData,c as defineAssert,p as defineHook,x as encodeDocData};
+import*as t from"zod";import*as s from"zod";import*as n from"zod";var T=n.bigint(),p=n.bigint(),a=n.custom(e=>e instanceof Uint8Array,{message:"Expected Uint8Array"}),j=n.custom(e=>e instanceof Uint8Array,{message:"Expected Uint8Array"}),i=j;import*as r from"zod";var z=r.string().max(1024),d=r.object({owner:i,data:a,description:z.optional(),created_at:T,updated_at:T,version:p.optional()}).strict(),h=r.object({before:d.optional(),after:d}).strict(),H=r.object({data:a,description:z.optional(),version:p.optional()}).strict(),l=r.object({current:d.optional(),proposed:H}).strict(),P=r.object({data:a,description:z.optional(),version:p.optional()}).strict();var A=e=>s.object({caller:i,data:e}).strict(),D=e=>s.object({collection:s.string(),key:s.string(),data:e}).strict(),O=A(D(h)),k=A(D(l));import*as c from"zod";var m=c.object({collections:c.array(c.string()).min(1)}).strict();import*as x from"zod";var f=x.record(x.unknown());var _=e=>m.extend({assert:t.function().args(e).returns(t.promise(t.void()))}).strict(),b=_(k),M=b,C=e=>t.function().args(f).returns(e),Q=e=>t.union([e,C(e)]);function W(e){return e}import*as o from"zod";var g=e=>m.extend({run:o.function().args(e).returns(o.promise(o.void()))}).strict(),F=g(O),te=F,w=e=>o.function().args(f).returns(e),oe=e=>o.union([e,w(e)]);function re(e){return e}import{jsonReplacer as R,jsonReviver as U}from"@dfinity/utils";var ce=e=>JSON.parse(__juno_satellite_datastore_raw_data_to_text(e),U),pe=e=>__juno_satellite_datastore_raw_data_from_text(JSON.stringify(e,R));import{jsonReplacer as v}from"@dfinity/utils";var S=e=>{let u=e.map(y=>typeof y=="object"?JSON.stringify(y,v):y).join(" ");globalThis.__ic_cdk_print(u)};globalThis.console={info(...e){S(e)},log(...e){S(e)},warn(...e){S(e)},error(...e){S(e)}};export{Q as AssertFnOrObjectSchema,C as AssertFnSchema,M as AssertSchema,k as AssertSetDocContextSchema,b as AssertSetDocSchema,m as CollectionsConfigSchema,l as DocAssertSetSchema,D as DocContextSchema,z as DocDescriptionSchema,d as DocSchema,h as DocUpsertSchema,oe as HookFnOrObjectSchema,w as HookFnSchema,te as HookSchema,O as OnSetDocContextSchema,F as OnSetDocSchema,H as ProposedDocSchema,a as RawDataSchema,j as RawPrincipalSchema,i as RawUserIdSchema,f as SatelliteEnvSchema,P as SetDocSchema,T as TimestampSchema,p as VersionSchema,ce as decodeDocData,W as defineAssert,re as defineHook,pe as encodeDocData};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/configs/assert.config.ts", "../../src/configs/hook.config.ts", "../../src/sdk/datastore.sdk.ts", "../../src/polyfills/console.polyfill.ts"],
-  "sourcesContent": ["import type {AssertSetDocContext} from '../hooks/context';\nimport type {CollectionsConfig} from './collection.config';\nimport type {SatelliteConfigEnv} from './satellite.config';\n\n/**\n * The generic configuration for assertion hooks that manage collections.\n */\nexport interface AssertAssertConfig extends CollectionsConfig {\n  assertSetDoc: never;\n}\n\n/**\n * A configuration object that includes the `assertSetDoc` function.\n * This function is called to validate a document before it is created or updated.\n */\nexport interface AssertSetDocConfig extends Omit<AssertAssertConfig, 'assertSetDoc'> {\n  /**\n   * A function that runs synchronously before a document is set in the Datastore.\n   * This can be used to enforce your validation rules.\n   *\n   * @param {AssertSetDocContext} context - Provides details about the document being validated.\n   * @throws {Error} If your validation fails, throw an exception to prevent the document from being saved.\n   *\n   */\n  assertSetDoc: (context: AssertSetDocContext) => void;\n}\n\nexport type AssertConfig = AssertSetDocConfig;\n\nexport type AssertFn = (config: SatelliteConfigEnv) => AssertConfig;\n\nexport type AssertFnOrObject = AssertConfig | AssertFn;\n\nexport function defineAssert(config: AssertConfig): AssertConfig;\nexport function defineAssert(config: AssertFn): AssertFn;\nexport function defineAssert(config: AssertFnOrObject): AssertFnOrObject;\nexport function defineAssert(config: AssertFnOrObject): AssertFnOrObject {\n  return config;\n}\n", "import type {OnSetDocContext} from '../hooks/context';\nimport type {CollectionsConfig} from './collection.config';\nimport type {SatelliteConfigEnv} from './satellite.config';\n\n/**\n * The generic configuration for hooks that manage collections.\n */\nexport interface OnHookConfig extends CollectionsConfig {\n  onSetDoc: never;\n}\n\n/**\n * A configuration object that includes the `onSetDoc` function.\n * This function is called when a document is created or updated.\n */\nexport interface OnSetDocConfig extends Omit<OnHookConfig, 'onSetDoc'> {\n  /**\n   * A function that runs when a document is set in the Datastore.\n   *\n   * @param {OnSetDocContext} context - Provides details about the document being saved.\n   * @returns {Promise<void>} Resolves when your operation is complete.\n   */\n  onSetDoc: (context: OnSetDocContext) => Promise<void>;\n}\n\nexport type HookConfig = OnSetDocConfig; // TODO: to be extended\n\nexport type HookFn = (config: SatelliteConfigEnv) => HookConfig;\n\nexport type HookFnOrObject = HookConfig | HookFn;\n\nexport function defineHook(config: HookConfig): HookConfig;\nexport function defineHook(config: HookFn): HookFn;\nexport function defineHook(config: HookFnOrObject): HookFnOrObject;\nexport function defineHook(config: HookFnOrObject): HookFnOrObject {\n  return config;\n}\n", "import {jsonReplacer, jsonReviver} from '@dfinity/utils';\nimport type {RawData} from '../hooks/core';\n\nexport const decodeDocData = <T>(data: RawData): T =>\n  JSON.parse(__juno_satellite_datastore_raw_data_to_text(data), jsonReviver);\n\nexport const encodeDocData = <T>(data: T): RawData =>\n  __juno_satellite_datastore_raw_data_from_text(JSON.stringify(data, jsonReplacer));\n", "import {jsonReplacer} from '@dfinity/utils';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst __juno_satellite_console_log = (v: any[]) => {\n  const msg = v\n    .map((arg) => (typeof arg === 'object' ? JSON.stringify(arg, jsonReplacer) : arg))\n    .join(' ');\n\n  globalThis.__ic_cdk_print(msg);\n};\n\n// @ts-expect-error We want to override the console\nglobalThis.console = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  info(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  log(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  warn(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  error(...v: any[]) {\n    __juno_satellite_console_log(v);\n  }\n};\n"],
-  "mappings": "AAoCO,SAASA,EAAaC,EAA4C,CACvE,OAAOA,CACT,CCJO,SAASC,EAAWC,EAAwC,CACjE,OAAOA,CACT,CCpCA,OAAQ,gBAAAC,EAAc,eAAAC,MAAkB,iBAGjC,IAAMC,EAAoBC,GAC/B,KAAK,MAAM,4CAA4CA,CAAI,EAAGF,CAAW,EAE9DG,EAAoBD,GAC/B,8CAA8C,KAAK,UAAUA,EAAMH,CAAY,CAAC,ECPlF,OAAQ,gBAAAK,MAAmB,iBAG3B,IAAMC,EAAgCC,GAAa,CACjD,IAAMC,EAAMD,EACT,IAAKE,GAAS,OAAOA,GAAQ,SAAW,KAAK,UAAUA,EAAKJ,CAAY,EAAII,CAAI,EAChF,KAAK,GAAG,EAEX,WAAW,eAAeD,CAAG,CAC/B,EAGA,WAAW,QAAU,CAEnB,QAAQD,EAAU,CAChBD,EAA6BC,CAAC,CAChC,EAEA,OAAOA,EAAU,CACfD,EAA6BC,CAAC,CAChC,EAEA,QAAQA,EAAU,CAChBD,EAA6BC,CAAC,CAChC,EAEA,SAASA,EAAU,CACjBD,EAA6BC,CAAC,CAChC,CACF",
-  "names": ["defineAssert", "config", "defineHook", "config", "jsonReplacer", "jsonReviver", "decodeDocData", "data", "encodeDocData", "jsonReplacer", "__juno_satellite_console_log", "v", "msg", "arg"]
+  "sources": ["../../src/configs/assertions.ts", "../../src/hooks/context.ts", "../../src/hooks/core.ts", "../../src/hooks/datastore.ts", "../../src/configs/collections.config.ts", "../../src/configs/satellite.env.ts", "../../src/configs/hooks.ts", "../../src/sdk/datastore.sdk.ts", "../../src/polyfills/console.polyfill.ts"],
+  "sourcesContent": ["import * as z from 'zod';\nimport {AssertSetDocContextSchema} from '../hooks/context';\nimport {CollectionsConfigSchema} from './collections.config';\nimport {SatelliteEnvSchema} from './satellite.env';\n\n/**\n * A generic schema for defining assertions related to collections.\n *\n * @template T - The type of context passed to the assertions when triggered.\n */\nconst OnAssertSchema = <T extends z.ZodTypeAny>(contextSchema: T) =>\n  CollectionsConfigSchema.extend({\n    /**\n     * A function that runs when the assertion is triggered for the specified collections.\n     *\n     * @param {T} context - Contains information about the affected document(s).\n     * @returns {Promise<void>} Resolves when the operation completes.\n     */\n    assert: z.function().args(contextSchema).returns(z.promise(z.void()))\n  }).strict();\n\n/**\n * @see AssertSetDoc\n */\nexport const AssertSetDocSchema = OnAssertSchema(AssertSetDocContextSchema);\n\n/**\n * An assertion that runs when a document is created or updated.\n */\nexport type AssertSetDoc = z.infer<typeof AssertSetDocSchema>;\n\n// TODO: to be extended\n/**\n * @see Assert\n */\nexport const AssertSchema = AssertSetDocSchema;\n\n/**\n * All assertions definitions.\n */\nexport type Assert = z.infer<typeof AssertSchema>;\n\nexport const AssertFnSchema = <T extends z.ZodTypeAny>(assertSchema: T) =>\n  z.function().args(SatelliteEnvSchema).returns(assertSchema);\nexport type AssertFn<T extends Assert> = (assert: z.infer<typeof SatelliteEnvSchema>) => T;\n\nexport const AssertFnOrObjectSchema = <T extends z.ZodTypeAny>(assertSchema: T) =>\n  z.union([assertSchema, AssertFnSchema(assertSchema)]);\nexport type AssertFnOrObject<T extends Assert> = T | AssertFn<T>;\n\nexport function defineAssert<T extends Assert>(assert: T): T;\nexport function defineAssert<T extends Assert>(assert: AssertFn<T>): AssertFn<T>;\nexport function defineAssert<T extends Assert>(assert: AssertFnOrObject<T>): AssertFnOrObject<T>;\nexport function defineAssert<T extends Assert>(assert: AssertFnOrObject<T>): AssertFnOrObject<T> {\n  return assert;\n}\n", "import * as z from 'zod';\nimport {RawUserIdSchema} from './core';\nimport {DocAssertSetSchema, DocUpsertSchema} from './datastore';\n\n/**\n * @see HookContext\n */\nconst HookContextSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>\n  z\n    .object({\n      /**\n       * The user who originally triggered the function that in turn triggered the hook.\n       */\n      caller: RawUserIdSchema,\n\n      /**\n       * The data associated with the hook execution.\n       */\n      data: dataSchema\n    })\n    .strict();\n\n/**\n * Represents the context provided to hooks, containing information about the caller and related data.\n *\n * @template T - The type of data associated with the hook.\n */\nexport type HookContext<T extends z.ZodTypeAny> = z.infer<ReturnType<typeof HookContextSchema<T>>>;\n\n/**\n * @see DocContext\n */\nexport const DocContextSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>\n  z\n    .object({\n      /**\n       * The name of the collection where the document is stored.\n       */\n      collection: z.string(),\n\n      /**\n       * The unique key identifying the document within the collection.\n       */\n      key: z.string(),\n\n      /**\n       * The data associated with the document operation.\n       */\n      data: dataSchema\n    })\n    .strict();\n\n/**\n * Represents the context of a document operation within a collection.\n *\n * @template T - The type of data associated with the document.\n */\nexport type DocContext<T extends z.ZodTypeAny> = z.infer<ReturnType<typeof DocContextSchema<T>>>;\n\n/**\n * @see OnSetDocContext\n */\nexport const OnSetDocContextSchema = HookContextSchema(DocContextSchema(DocUpsertSchema));\n\n/**\n * The context provided to the `onSetDoc` hook.\n *\n * This context contains information about the document being created or updated,\n * along with details about the user who triggered the operation.\n */\nexport type OnSetDocContext = z.infer<typeof OnSetDocContextSchema>;\n\n/**\n * @see AssertSetDocContext\n */\nexport const AssertSetDocContextSchema = HookContextSchema(DocContextSchema(DocAssertSetSchema));\n\n/**\n * The context provided to the `assertSetDoc` hook.\n *\n * This context contains information about the document being validated before\n * it is created or updated. If validation fails, the developer should throw an error.\n */\nexport type AssertSetDocContext = z.infer<typeof AssertSetDocContextSchema>;\n", "import * as z from 'zod';\n\n/**\n * @see Timestamp\n */\nexport const TimestampSchema = z.bigint();\n\n/**\n * Represents a timestamp in nanoseconds since the Unix epoch.\n *\n * Used for tracking when events occur, such as document creation and updates.\n */\nexport type Timestamp = z.infer<typeof TimestampSchema>;\n\n/**\n * @see Version\n */\nexport const VersionSchema = z.bigint();\n\n/**\n * Represents a version number for tracking changes.\n *\n * This is typically incremented with each update to ensure consistency.\n */\nexport type Version = z.infer<typeof VersionSchema>;\n\n/**\n * @see RawData\n */\nexport const RawDataSchema = z.custom<Uint8Array>((val) => val instanceof Uint8Array, {\n  message: 'Expected Uint8Array'\n});\n\n/**\n * Represents raw binary data.\n *\n * This is used to store unstructured data in a document.\n */\nexport type RawData = z.infer<typeof RawDataSchema>;\n\n/**\n * @see RawPrincipal\n */\nexport const RawPrincipalSchema = z.custom<Uint8Array>((val) => val instanceof Uint8Array, {\n  message: 'Expected Uint8Array'\n});\n\n/**\n * Represents a raw principal identifier.\n *\n * Principals are unique identities used in authentication and authorization.\n */\nexport type RawPrincipal = z.infer<typeof RawPrincipalSchema>;\n\n/**\n * @see RawUserId\n */\nexport const RawUserIdSchema = RawPrincipalSchema;\n\n/**\n * Represents a raw user identifier.\n *\n * This is a principal associated with a user.\n */\nexport type RawUserId = z.infer<typeof RawUserIdSchema>;\n", "import * as z from 'zod';\nimport {RawDataSchema, RawUserIdSchema, TimestampSchema, VersionSchema} from './core';\n\n/**\n * @see DocDescription\n */\nexport const DocDescriptionSchema = z.string().max(1024);\n\n/**\n * Represents a document description with a maximum length of 1024 characters.\n */\nexport type DocDescription = z.infer<typeof DocDescriptionSchema>;\n\n/**\n * @see Doc\n */\nexport const DocSchema = z\n  .object({\n    /**\n     * The user who owns this document.\n     */\n    owner: RawUserIdSchema,\n\n    /**\n     * The raw data of the document.\n     */\n    data: RawDataSchema,\n\n    /**\n     * An optional description of the document.\n     */\n    description: DocDescriptionSchema.optional(),\n\n    /**\n     * The timestamp when the document was first created.\n     */\n    created_at: TimestampSchema,\n\n    /**\n     * The timestamp when the document was last updated.\n     */\n    updated_at: TimestampSchema,\n\n    /**\n     * The version number of the document, used for consistency checks.\n     * If not provided, it's assumed to be the first version.\n     */\n    version: VersionSchema.optional()\n  })\n  .strict();\n\n/**\n * Represents a document stored in a collection.\n */\nexport type Doc = z.infer<typeof DocSchema>;\n\n/**\n * @see DocUpsert\n */\nexport const DocUpsertSchema = z\n  .object({\n    /**\n     * The previous version of the document before the update.\n     * Undefined if this is a new document.\n     */\n    before: DocSchema.optional(),\n\n    /**\n     * The new version of the document after the update.\n     */\n    after: DocSchema\n  })\n  .strict();\n\n/**\n * Represents a document update operation.\n *\n * This is used in hooks where a document is either being created or updated.\n */\nexport type DocUpsert = z.infer<typeof DocUpsertSchema>;\n\n/**\n * @see ProposedDoc\n */\nexport const ProposedDocSchema = z\n  .object({\n    /**\n     * The raw data of the document.\n     */\n    data: RawDataSchema,\n\n    /**\n     * An optional description of the document.\n     */\n    description: DocDescriptionSchema.optional(),\n\n    /**\n     * The expected version number to ensure consistency.\n     */\n    version: VersionSchema.optional()\n  })\n  .strict();\n\n/**\n * Represents the proposed version of a document.\n * This can be validated before allowing the operation.\n */\nexport type ProposedDoc = z.infer<typeof ProposedDocSchema>;\n\n/**\n * @see DocAssertSet\n */\nexport const DocAssertSetSchema = z\n  .object({\n    /**\n     * The current version of the document before the operation.\n     * Undefined if this is a new document.\n     */\n    current: DocSchema.optional(),\n\n    /**\n     * The proposed version of the document.\n     * This can be validated before allowing the operation.\n     */\n    proposed: ProposedDocSchema\n  })\n  .strict();\n\n/**\n * Represents a validation check before setting a document.\n *\n * The developer can compare the `current` and `proposed` versions and\n * throw an error if their validation fails.\n */\nexport type DocAssertSet = z.infer<typeof DocAssertSetSchema>;\n\n/**\n * @see SetDoc\n */\nexport const SetDocSchema = z\n  .object({\n    /**\n     * The raw data of the document.\n     */\n    data: RawDataSchema,\n\n    /**\n     * An optional description of the document.\n     */\n    description: DocDescriptionSchema.optional(),\n\n    /**\n     * The expected version number to ensure consistency.\n     * If provided, the operation will fail if the stored version does not match.\n     */\n    version: VersionSchema.optional()\n  })\n  .strict();\n\n/**\n * Represents a request to set or update a document.\n *\n * This is used when submitting new document data.\n */\nexport type SetDoc = z.infer<typeof SetDocSchema>;\n", "import * as z from 'zod';\n\n/**\n * @see CollectionsConfig\n */\nexport const CollectionsConfigSchema = z\n  .object({\n    /**\n     * An array containing at least one collection name where the hook or assertion will be executed.\n     */\n    collections: z.array(z.string()).min(1)\n  })\n  .strict();\n\n/**\n * Defines the collections where a hook or assertion should run.\n */\nexport type CollectionsConfig = z.infer<typeof CollectionsConfigSchema>;\n", "import * as z from 'zod';\n\n/**\n * @see SatelliteEnv\n */\nexport const SatelliteEnvSchema = z.record(z.unknown());\n\n/**\n * Placeholder for future environment-specific configurations.\n *\n * Currently unused, but it may support features such as:\n * - Defining the execution mode (e.g., staging or production).\n * - Providing environment-specific values like `ckBtcLedgerId` for test or production.\n */\nexport type SatelliteEnv = z.infer<typeof SatelliteEnvSchema>;\n", "import * as z from 'zod';\nimport {OnSetDocContextSchema} from '../hooks/context';\nimport {CollectionsConfigSchema} from './collections.config';\nimport {SatelliteEnvSchema} from './satellite.env';\n\n/**\n * A generic schema for defining hooks related to collections.\n *\n * @template T - The type of context passed to the hook when triggered.\n */\nconst OnHookSchema = <T extends z.ZodTypeAny>(contextSchema: T) =>\n  CollectionsConfigSchema.extend({\n    /**\n     * A function that runs when the hook is triggered for the specified collections.\n     *\n     * @param {T} context - Contains information about the affected document(s).\n     * @returns {Promise<void>} Resolves when the operation completes.\n     */\n    run: z.function().args(contextSchema).returns(z.promise(z.void()))\n  }).strict();\n\n/**\n * @see OnSetDoc\n */\nexport const OnSetDocSchema = OnHookSchema(OnSetDocContextSchema);\n\n/**\n * A hook that runs when a document is created or updated.\n */\nexport type OnSetDoc = z.infer<typeof OnSetDocSchema>;\n\n// TODO: to be extended\n/**\n * @see Hook\n */\nexport const HookSchema = OnSetDocSchema;\n\n/**\n * All hooks definitions.\n */\nexport type Hook = z.infer<typeof HookSchema>;\n\nexport const HookFnSchema = <T extends z.ZodTypeAny>(hookSchema: T) =>\n  z.function().args(SatelliteEnvSchema).returns(hookSchema);\nexport type HookFn<T extends Hook> = (hook: z.infer<typeof SatelliteEnvSchema>) => T;\n\nexport const HookFnOrObjectSchema = <T extends z.ZodTypeAny>(hookSchema: T) =>\n  z.union([hookSchema, HookFnSchema(hookSchema)]);\nexport type HookFnOrObject<T extends Hook> = T | HookFn<T>;\n\nexport function defineHook<T extends Hook>(hook: T): T;\nexport function defineHook<T extends Hook>(hook: HookFn<T>): HookFn<T>;\nexport function defineHook<T extends Hook>(hook: HookFnOrObject<T>): HookFnOrObject<T>;\nexport function defineHook<T extends Hook>(hook: HookFnOrObject<T>): HookFnOrObject<T> {\n  return hook;\n}\n", "import {jsonReplacer, jsonReviver} from '@dfinity/utils';\nimport type {RawData} from '../hooks/core';\n\nexport const decodeDocData = <T>(data: RawData): T =>\n  JSON.parse(__juno_satellite_datastore_raw_data_to_text(data), jsonReviver);\n\nexport const encodeDocData = <T>(data: T): RawData =>\n  __juno_satellite_datastore_raw_data_from_text(JSON.stringify(data, jsonReplacer));\n", "import {jsonReplacer} from '@dfinity/utils';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst __juno_satellite_console_log = (v: any[]) => {\n  const msg = v\n    .map((arg) => (typeof arg === 'object' ? JSON.stringify(arg, jsonReplacer) : arg))\n    .join(' ');\n\n  globalThis.__ic_cdk_print(msg);\n};\n\n// @ts-expect-error We want to override the console\nglobalThis.console = {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  info(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  log(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  warn(...v: any[]) {\n    __juno_satellite_console_log(v);\n  },\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  error(...v: any[]) {\n    __juno_satellite_console_log(v);\n  }\n};\n"],
+  "mappings": "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",
+  "names": ["z", "z", "z", "TimestampSchema", "VersionSchema", "RawDataSchema", "val", "RawPrincipalSchema", "RawUserIdSchema", "z", "DocDescriptionSchema", "DocSchema", "RawUserIdSchema", "RawDataSchema", "TimestampSchema", "VersionSchema", "DocUpsertSchema", "ProposedDocSchema", "DocAssertSetSchema", "SetDocSchema", "HookContextSchema", "dataSchema", "RawUserIdSchema", "DocContextSchema", "OnSetDocContextSchema", "DocUpsertSchema", "AssertSetDocContextSchema", "DocAssertSetSchema", "z", "CollectionsConfigSchema", "z", "SatelliteEnvSchema", "OnAssertSchema", "contextSchema", "CollectionsConfigSchema", "AssertSetDocSchema", "AssertSetDocContextSchema", "AssertSchema", "AssertFnSchema", "assertSchema", "SatelliteEnvSchema", "AssertFnOrObjectSchema", "defineAssert", "assert", "z", "OnHookSchema", "contextSchema", "CollectionsConfigSchema", "OnSetDocSchema", "OnSetDocContextSchema", "HookSchema", "HookFnSchema", "hookSchema", "SatelliteEnvSchema", "HookFnOrObjectSchema", "defineHook", "hook", "jsonReplacer", "jsonReviver", "decodeDocData", "data", "encodeDocData", "jsonReplacer", "__juno_satellite_console_log", "v", "msg", "arg"]
 }

package/dist/types/configs/assertions.d.ts

@@ -0,0 +1,439 @@
+import * as z from 'zod';
+import { SatelliteEnvSchema } from './satellite.env';
+/**
+ * @see AssertSetDoc
+ */
+export declare const AssertSetDocSchema: z.ZodObject<z.objectUtil.extendShape<{
+    collections: z.ZodArray<z.ZodString, "many">;
+}, {
+    /**
+     * A function that runs when the assertion is triggered for the specified collections.
+     *
+     * @param {T} context - Contains information about the affected document(s).
+     * @returns {Promise<void>} Resolves when the operation completes.
+     */
+    assert: z.ZodFunction<z.ZodTuple<[z.ZodObject<{
+        caller: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+        data: z.ZodObject<{
+            collection: z.ZodString;
+            key: z.ZodString;
+            data: z.ZodObject<{
+                current: z.ZodOptional<z.ZodObject<{
+                    owner: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    description: z.ZodOptional<z.ZodString>;
+                    created_at: z.ZodBigInt;
+                    updated_at: z.ZodBigInt;
+                    version: z.ZodOptional<z.ZodBigInt>;
+                }, "strict", z.ZodTypeAny, {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }, {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }>>;
+                proposed: z.ZodObject<{
+                    data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    description: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodBigInt>;
+                }, "strict", z.ZodTypeAny, {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }, {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }>;
+            }, "strict", z.ZodTypeAny, {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            }, {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        }, {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }>], z.ZodUnknown>, z.ZodPromise<z.ZodVoid>>;
+}>, "strict", z.ZodTypeAny, {
+    collections: string[];
+    assert: (args_0: {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, ...args: unknown[]) => Promise<void>;
+}, {
+    collections: string[];
+    assert: (args_0: {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, ...args: unknown[]) => Promise<void>;
+}>;
+/**
+ * An assertion that runs when a document is created or updated.
+ */
+export type AssertSetDoc = z.infer<typeof AssertSetDocSchema>;
+/**
+ * @see Assert
+ */
+export declare const AssertSchema: z.ZodObject<z.objectUtil.extendShape<{
+    collections: z.ZodArray<z.ZodString, "many">;
+}, {
+    /**
+     * A function that runs when the assertion is triggered for the specified collections.
+     *
+     * @param {T} context - Contains information about the affected document(s).
+     * @returns {Promise<void>} Resolves when the operation completes.
+     */
+    assert: z.ZodFunction<z.ZodTuple<[z.ZodObject<{
+        caller: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+        data: z.ZodObject<{
+            collection: z.ZodString;
+            key: z.ZodString;
+            data: z.ZodObject<{
+                current: z.ZodOptional<z.ZodObject<{
+                    owner: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    description: z.ZodOptional<z.ZodString>;
+                    created_at: z.ZodBigInt;
+                    updated_at: z.ZodBigInt;
+                    version: z.ZodOptional<z.ZodBigInt>;
+                }, "strict", z.ZodTypeAny, {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }, {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }>>;
+                proposed: z.ZodObject<{
+                    data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+                    description: z.ZodOptional<z.ZodString>;
+                    version: z.ZodOptional<z.ZodBigInt>;
+                }, "strict", z.ZodTypeAny, {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }, {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                }>;
+            }, "strict", z.ZodTypeAny, {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            }, {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        }, {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }>], z.ZodUnknown>, z.ZodPromise<z.ZodVoid>>;
+}>, "strict", z.ZodTypeAny, {
+    collections: string[];
+    assert: (args_0: {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, ...args: unknown[]) => Promise<void>;
+}, {
+    collections: string[];
+    assert: (args_0: {
+        data: {
+            data: {
+                proposed: {
+                    data: Uint8Array<ArrayBufferLike>;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                };
+                current?: {
+                    owner: Uint8Array<ArrayBufferLike>;
+                    data: Uint8Array<ArrayBufferLike>;
+                    created_at: bigint;
+                    updated_at: bigint;
+                    description?: string | undefined;
+                    version?: bigint | undefined;
+                } | undefined;
+            };
+            collection: string;
+            key: string;
+        };
+        caller: Uint8Array<ArrayBufferLike>;
+    }, ...args: unknown[]) => Promise<void>;
+}>;
+/**
+ * All assertions definitions.
+ */
+export type Assert = z.infer<typeof AssertSchema>;
+export declare const AssertFnSchema: <T extends z.ZodTypeAny>(assertSchema: T) => z.ZodFunction<z.ZodTuple<[z.ZodRecord<z.ZodString, z.ZodUnknown>], z.ZodUnknown>, T>;
+export type AssertFn<T extends Assert> = (assert: z.infer<typeof SatelliteEnvSchema>) => T;
+export declare const AssertFnOrObjectSchema: <T extends z.ZodTypeAny>(assertSchema: T) => z.ZodUnion<[T, z.ZodFunction<z.ZodTuple<[z.ZodRecord<z.ZodString, z.ZodUnknown>], z.ZodUnknown>, T>]>;
+export type AssertFnOrObject<T extends Assert> = T | AssertFn<T>;
+export declare function defineAssert<T extends Assert>(assert: T): T;
+export declare function defineAssert<T extends Assert>(assert: AssertFn<T>): AssertFn<T>;
+export declare function defineAssert<T extends Assert>(assert: AssertFnOrObject<T>): AssertFnOrObject<T>;

package/dist/types/configs/collections.config.d.ts

@@ -0,0 +1,18 @@
+import * as z from 'zod';
+/**
+ * @see CollectionsConfig
+ */
+export declare const CollectionsConfigSchema: z.ZodObject<{
+    /**
+     * An array containing at least one collection name where the hook or assertion will be executed.
+     */
+    collections: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    collections: string[];
+}, {
+    collections: string[];
+}>;
+/**
+ * Defines the collections where a hook or assertion should run.
+ */
+export type CollectionsConfig = z.infer<typeof CollectionsConfigSchema>;