@junobuild/functions 0.7.1 → 0.7.2-next-2026-03-20

package/README.md

@@ -46,11 +46,9 @@ JavaScript and TypeScript utilities for [Juno] Serverless Functions.
 - [createListResultsSchema](#gear-createlistresultsschema)
 - [decodeDocData](#gear-decodedocdata)
 - [encodeDocData](#gear-encodedocdata)
+- [getAdminAccessKeys](#gear-getadminaccesskeys)
+- [getAccessKeys](#gear-getaccesskeys)
 - [normalizeCaller](#gear-normalizecaller)
-- [getAdminControllers](#gear-getadmincontrollers)
-- [getControllers](#gear-getcontrollers)
-- [isAdminController](#gear-isadmincontroller)
-- [isController](#gear-iscontroller)
 - [setDocStore](#gear-setdocstore)
 - [deleteDocStore](#gear-deletedocstore)
 - [getDocStore](#gear-getdocstore)
@@ -59,6 +57,9 @@ JavaScript and TypeScript utilities for [Juno] Serverless Functions.
 - [countDocsStore](#gear-countdocsstore)
 - [deleteDocsStore](#gear-deletedocsstore)
 - [deleteFilteredDocsStore](#gear-deletefiltereddocsstore)
+- [callerIsAdmin](#gear-callerisadmin)
+- [callerHasWritePermission](#gear-callerhaswritepermission)
+- [callerIsAccessKey](#gear-callerisaccesskey)
 - [countCollectionAssetsStore](#gear-countcollectionassetsstore)
 - [countAssetsStore](#gear-countassetsstore)
 - [setAssetHandler](#gear-setassethandler)
@@ -398,90 +399,52 @@ The serialized raw data.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/serializer.sdk.ts#L21)
 
-#### :gear: normalizeCaller
-
-Normalizes a user ID into a raw `Uint8Array` representation.
-
-| Function          | Type                            |
-| ----------------- | ------------------------------- |
-| `normalizeCaller` | `(caller: any) => RawPrincipal` |
-
-Parameters:
-
-- `caller`: - The caller identity, either a raw `Uint8Array`
-  or a `Principal` instance.
-
-Returns:
-
-The raw user ID as a `Uint8Array`.
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/utils/caller.utils.ts#L12)
-
-#### :gear: getAdminControllers
-
-Gets the list of admin controllers from the Satellite.
-
-| Function              | Type                                                                                                                                                                                                                                        |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `getAdminControllers` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
-
-Returns:
-
-The list of admin controllers.
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/controllers.sdk.ts#L15)
+#### :gear: getAdminAccessKeys
 
-#### :gear: getControllers
+Gets the list of admin access keys from the Satellite.
 
-Gets the list of controllers from the Satellite.
-
-| Function         | Type                                                                                                                                                                                                                                        |
-| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `getControllers` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
+| Function             | Type                                                                                                                                                                                                                                        |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getAdminAccessKeys` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
 
 Returns:
 
-The list of all controllers.
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/controllers.sdk.ts#L24)
+The list of admin acces keys.
 
-#### :gear: isAdminController
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/accessKeys.sdk.ts#L10)
 
-Checks if the given caller is an admin among the provided controllers.
+#### :gear: getAccessKeys
 
-| Function            | Type                                         |
-| ------------------- | -------------------------------------------- |
-| `isAdminController` | `(params: ControllerCheckParams) => boolean` |
+Gets the list of access keys from the Satellite.
 
-Parameters:
-
-- `params`: - The parameters including the caller identity
-  and the list of controllers to verify against.
+| Function        | Type                                                                                                                                                                                                                                        |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getAccessKeys` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
 
 Returns:
 
-Whether the caller is an admin.
+The list of all access keys.
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/controllers.sdk.ts#L36)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/accessKeys.sdk.ts#L19)
 
-#### :gear: isController
+#### :gear: normalizeCaller
 
-Checks if the given caller exists among the provided controllers.
+Normalizes a user ID into a raw `Uint8Array` representation.
 
-| Function       | Type                                         |
-| -------------- | -------------------------------------------- |
-| `isController` | `(params: ControllerCheckParams) => boolean` |
+| Function          | Type                            |
+| ----------------- | ------------------------------- |
+| `normalizeCaller` | `(caller: any) => RawPrincipal` |
 
 Parameters:
 
-- `params`: - The parameters including the caller identity
-  and the list of controllers to verify against.
+- `caller`: - The caller identity, either a raw `Uint8Array`
+  or a `Principal` instance.
 
 Returns:
 
-Whether the caller is a controller.
+The raw user ID as a `Uint8Array`.
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/controllers.sdk.ts#L56)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/utils/caller.utils.ts#L12)
 
 #### :gear: setDocStore
 
@@ -629,6 +592,36 @@ The context resulting of the deletion of documents that match the provided filte
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/db.sdk.ts#L175)
 
+#### :gear: callerIsAdmin
+
+Guard that succeeds if the caller is an admin access key of this satellite.
+
+| Function        | Type         |
+| --------------- | ------------ |
+| `callerIsAdmin` | `() => void` |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/guards.sdk.ts#L10)
+
+#### :gear: callerHasWritePermission
+
+Guard that succeeds if the caller is an access key with write permission.
+
+| Function                   | Type                                                                                                                                                                                                                                        |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `callerHasWritePermission` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/guards.sdk.ts#L21)
+
+#### :gear: callerIsAccessKey
+
+Guard that succeeds if the caller is any recognized access key of this satellite.
+
+| Function            | Type                                                                                                                                                                                                                                        |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `callerIsAccessKey` | `() => [Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` |
+
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/guards.sdk.ts#L31)
+
 #### :gear: countCollectionAssetsStore
 
 Counts the number of assets in a specific collection.
@@ -916,9 +909,7 @@ The current timestamp.
 - [CustomFunctionSchema](#gear-customfunctionschema)
 - [QuerySchema](#gear-queryschema)
 - [UpdateSchema](#gear-updateschema)
-- [Uint8ArraySchema](#gear-uint8arrayschema)
 - [RawPrincipalSchema](#gear-rawprincipalschema)
-- [PrincipalSchema](#gear-principalschema)
 - [TimestampSchema](#gear-timestampschema)
 - [VersionSchema](#gear-versionschema)
 - [RawUserIdSchema](#gear-rawuseridschema)
@@ -981,13 +972,12 @@ The current timestamp.
 - [ListOrderFieldSchema](#gear-listorderfieldschema)
 - [ListOrderSchema](#gear-listorderschema)
 - [ListParamsSchema](#gear-listparamsschema)
-- [ControllerScopeSchema](#gear-controllerscopeschema)
-- [ControllerKindSchema](#gear-controllerkindschema)
+- [AccessKeyScopeSchema](#gear-accesskeyscopeschema)
+- [AccessKeyKindSchema](#gear-accesskeykindschema)
 - [MetadataSchema](#gear-metadataschema)
-- [ControllerSchema](#gear-controllerschema)
-- [ControllerRecordSchema](#gear-controllerrecordschema)
-- [ControllersSchema](#gear-controllersschema)
-- [ControllerCheckParamsSchema](#gear-controllercheckparamsschema)
+- [AccessKeySchema](#gear-accesskeyschema)
+- [AccessKeyRecordSchema](#gear-accesskeyrecordschema)
+- [AccessKeysSchema](#gear-accesskeysschema)
 - [CollectionParamsSchema](#gear-collectionparamsschema)
 - [ListStoreParamsSchema](#gear-liststoreparamsschema)
 - [GetDocStoreParamsSchema](#gear-getdocstoreparamsschema)
@@ -1122,16 +1112,6 @@ References:
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/functions/update.ts#L23)
 
-#### :gear: Uint8ArraySchema
-
-A schema that validates a value is an Uint8Array.
-
-| Constant           | Type                                                          |
-| ------------------ | ------------------------------------------------------------- |
-| `Uint8ArraySchema` | `ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>` |
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/candid.ts#L10)
-
 #### :gear: RawPrincipalSchema
 
 | Constant             | Type                                                          |
@@ -1142,19 +1122,7 @@ References:
 
 - RawPrincipal
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/candid.ts#L15)
-
-#### :gear: PrincipalSchema
-
-| Constant          | Type                                                                           |
-| ----------------- | ------------------------------------------------------------------------------ |
-| `PrincipalSchema` | `ZodPipe<ZodCustom<Principal, Principal>, ZodTransform<Principal, Principal>>` |
-
-References:
-
-- Principal
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/candid.ts#L25)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/principal.ts#L6)
 
 #### :gear: TimestampSchema
 
@@ -1166,7 +1134,7 @@ References:
 
 - Timestamp
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L7)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L8)
 
 #### :gear: VersionSchema
 
@@ -1178,7 +1146,7 @@ References:
 
 - Version
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L19)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L20)
 
 #### :gear: RawUserIdSchema
 
@@ -1190,19 +1158,19 @@ References:
 
 - RawUserId
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L31)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L32)
 
 #### :gear: UserIdSchema
 
-| Constant       | Type                                                                           |
-| -------------- | ------------------------------------------------------------------------------ |
-| `UserIdSchema` | `ZodPipe<ZodCustom<Principal, Principal>, ZodTransform<Principal, Principal>>` |
+| Constant       | Type                                                   |
+| -------------- | ------------------------------------------------------ |
+| `UserIdSchema` | `ZodPipe<ZodCustom<any, any>, ZodTransform<any, any>>` |
 
 References:
 
 - UserId
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L43)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L44)
 
 #### :gear: CollectionSchema
 
@@ -1214,7 +1182,7 @@ References:
 
 - Collection
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L55)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L56)
 
 #### :gear: KeySchema
 
@@ -1226,7 +1194,7 @@ References:
 
 - Key
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L65)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L66)
 
 #### :gear: DescriptionSchema
 
@@ -1238,7 +1206,7 @@ References:
 
 - Description
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L75)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L76)
 
 #### :gear: CollectionsSchema
 
@@ -1900,29 +1868,29 @@ References:
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/list.ts#L103)
 
-#### :gear: ControllerScopeSchema
+#### :gear: AccessKeyScopeSchema
 
-| Constant                | Type                                                             |
-| ----------------------- | ---------------------------------------------------------------- |
-| `ControllerScopeSchema` | `ZodEnum<{ write: "write"; admin: "admin"; submit: "submit"; }>` |
+| Constant               | Type                                                             |
+| ---------------------- | ---------------------------------------------------------------- |
+| `AccessKeyScopeSchema` | `ZodEnum<{ write: "write"; admin: "admin"; submit: "submit"; }>` |
 
 References:
 
-- ControllerScope
+- AccessKeyScope
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L15)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L8)
 
-#### :gear: ControllerKindSchema
+#### :gear: AccessKeyKindSchema
 
-| Constant               | Type                                                           |
-| ---------------------- | -------------------------------------------------------------- |
-| `ControllerKindSchema` | `ZodEnum<{ automation: "automation"; emulator: "emulator"; }>` |
+| Constant              | Type                                                           |
+| --------------------- | -------------------------------------------------------------- |
+| `AccessKeyKindSchema` | `ZodEnum<{ automation: "automation"; emulator: "emulator"; }>` |
 
 References:
 
-- ControllerKind
+- AccessKeyKind
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L25)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L18)
 
 #### :gear: MetadataSchema
 
@@ -1934,55 +1902,43 @@ References:
 
 - MetadataSchema
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L35)
-
-#### :gear: ControllerSchema
-
-| Constant           | Type                                                                                                                                                                                                           |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ControllerSchema` | `ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; created_at: ZodBigInt; updated_at: ZodBigInt; expires_at: ZodOptional<...>; scope: ZodEnum<...>; kind: ZodOptional<...>; }, $strict>` |
-
-References:
-
-- ControllerSchema
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L45)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L28)
 
-#### :gear: ControllerRecordSchema
+#### :gear: AccessKeySchema
 
-| Constant                 | Type                                                                                                                                                                                                         |
-| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `ControllerRecordSchema` | `ZodTuple<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; ... 4 more ...; kind: ZodOptional<...>; }, $strict>], null>` |
+| Constant          | Type                                                                                                                                                                                                           |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `AccessKeySchema` | `ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; created_at: ZodBigInt; updated_at: ZodBigInt; expires_at: ZodOptional<...>; scope: ZodEnum<...>; kind: ZodOptional<...>; }, $strict>` |
 
 References:
 
-- ControllerRecordSchema
+- AccessKeySchema
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L94)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L38)
 
-#### :gear: ControllersSchema
+#### :gear: AccessKeyRecordSchema
 
-| Constant            | Type                                                                                                                                                                                                                   |
-| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ControllersSchema` | `ZodArray<ZodTuple<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; ... 4 more ...; kind: ZodOptional<...>; }, $strict>], null>>` |
+| Constant                | Type                                                                                                                                                                                                         |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `AccessKeyRecordSchema` | `ZodTuple<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; ... 4 more ...; kind: ZodOptional<...>; }, $strict>], null>` |
 
 References:
 
-- ControllersSchema
+- AccessKeyRecordSchema
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L104)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L87)
 
-#### :gear: ControllerCheckParamsSchema
+#### :gear: AccessKeysSchema
 
-| Constant                      | Type                                                                                                                                                                                               |
-| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `ControllerCheckParamsSchema` | `ZodObject<{ caller: ZodUnion<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodPipe<ZodCustom<Principal, Principal>, ZodTransform<...>>]>; controllers: ZodArray<...>; }, $strip>` |
+| Constant           | Type                                                                                                                                                                                                                   |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `AccessKeysSchema` | `ZodArray<ZodTuple<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodObject<{ metadata: ZodArray<ZodTuple<[ZodString, ZodString], null>>; ... 4 more ...; kind: ZodOptional<...>; }, $strict>], null>>` |
 
 References:
 
-- ControllerCheckParamsSchema
+- AccessKeysSchema
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L114)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L97)
 
 #### :gear: CollectionParamsSchema
 
@@ -2246,7 +2202,7 @@ References:
 
 - IDLType
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L9)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L10)
 
 #### :gear: CallArgSchema
 
@@ -2258,7 +2214,7 @@ References:
 
 - CallArg
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L21)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L22)
 
 #### :gear: CallArgsSchema
 
@@ -2272,7 +2228,7 @@ References:
 
 - CallArgs
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L33)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L34)
 
 #### :gear: CallResultSchema
 
@@ -2284,19 +2240,19 @@ References:
 
 - CallResult
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L49)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L50)
 
 #### :gear: CallParamsSchema
 
-| Constant           | Type                                                                                                                                                                                                                                            |
-| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `CallParamsSchema` | `ZodObject<{ canisterId: ZodUnion<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodPipe<ZodCustom<Principal, Principal>, ZodTransform<...>>]>; method: ZodString; args: ZodOptional<...>; result: ZodOptional<...>; }, $strip>` |
+| Constant           | Type                                                                                                                                                                                                                                |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `CallParamsSchema` | `ZodObject<{ canisterId: ZodUnion<[ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>, ZodPipe<ZodCustom<any, any>, ZodTransform<...>>]>; method: ZodString; args: ZodOptional<...>; result: ZodOptional<...>; }, $strip>` |
 
 References:
 
 - CallParams
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L59)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L60)
 
 ### :factory: CallResponseLengthError
 
@@ -2328,8 +2284,7 @@ References:
 - [ListOrder](#gear-listorder)
 - [ListParams](#gear-listparams)
 - [ListResults](#gear-listresults)
-- [Controller](#gear-controller)
-- [ControllerCheckParams](#gear-controllercheckparams)
+- [AccessKey](#gear-accesskey)
 - [CollectionParams](#gear-collectionparams)
 - [SetAssetHandlerParams](#gear-setassethandlerparams)
 - [GetContentChunksStoreParams](#gear-getcontentchunksstoreparams)
@@ -2634,31 +2589,20 @@ List results, parameterized by type of returned item.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/list.ts#L142)
 
-#### :gear: Controller
+#### :gear: AccessKey
 
-Represents a controller with access scope and associated metadata.
+Represents an access key with access scope and associated metadata.
 
 | Property     | Type                                      | Description                                                        |
 | ------------ | ----------------------------------------- | ------------------------------------------------------------------ |
-| `metadata`   | `[string, string][]`                      | A list of key-value metadata pairs associated with the controller. |
-| `created_at` | `bigint`                                  | The timestamp when the controller was created.                     |
-| `updated_at` | `bigint`                                  | The timestamp when the controller was last updated.                |
-| `expires_at` | `bigint or undefined`                     | Optional expiration timestamp for the controller.                  |
-| `scope`      | `"write" or "admin" or "submit"`          | The scope assigned to the controller.                              |
-| `kind`       | `"automation" or "emulator" or undefined` | An optional kind identifier of the controller.                     |
+| `metadata`   | `[string, string][]`                      | A list of key-value metadata pairs associated with the access key. |
+| `created_at` | `bigint`                                  | The timestamp when the access key was created.                     |
+| `updated_at` | `bigint`                                  | The timestamp when the access key was last updated.                |
+| `expires_at` | `bigint or undefined`                     | Optional expiration timestamp for the access key.                  |
+| `scope`      | `"write" or "admin" or "submit"`          | The scope assigned to the access key.                              |
+| `kind`       | `"automation" or "emulator" or undefined` | An optional kind identifier of the access key.                     |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L59)
-
-#### :gear: ControllerCheckParams
-
-Represents the parameters required to perform controller checks.
-
-| Property      | Type                                                                                                                                                                                                                                  | Description                                                       |
-| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
-| `caller`      | `any`                                                                                                                                                                                                                                 | The identity of the caller to verify against the controller list. |
-| `controllers` | `[Uint8Array<ArrayBuffer>, { metadata: [string, string][]; created_at: bigint; updated_at: bigint; scope: "write" or "admin" or "submit"; expires_at?: bigint or undefined; kind?: "automation" or ... 1 more ... or undefined; }][]` | The list of controllers to check against.                         |
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L122)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L52)
 
 #### :gear: CollectionParams
 
@@ -2705,7 +2649,7 @@ Type representing the parameters required to make a canister call.
 | `args`       | `[IDL.Type<unknown>, unknown][] or undefined` | The arguments, including types and values, for the canister call. |
 | `result`     | `any`                                         | The expected result type used for decoding the response.          |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L69)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L70)
 
 ### :cocktail: Types
 
@@ -2721,7 +2665,6 @@ Type representing the parameters required to make a canister call.
 - [UpdateFn](#gear-updatefn)
 - [UpdateFnOrObject](#gear-updatefnorobject)
 - [RawPrincipal](#gear-rawprincipal)
-- [Principal](#gear-principal)
 - [Timestamp](#gear-timestamp)
 - [Version](#gear-version)
 - [RawUserId](#gear-rawuserid)
@@ -2783,11 +2726,11 @@ Type representing the parameters required to make a canister call.
 - [HookFnOrObject](#gear-hookfnorobject)
 - [TimestampMatcher](#gear-timestampmatcher)
 - [ListOrderField](#gear-listorderfield)
-- [ControllerScope](#gear-controllerscope)
-- [ControllerKind](#gear-controllerkind)
+- [AccessKeyScope](#gear-accesskeyscope)
+- [AccessKeyKind](#gear-accesskeykind)
 - [Metadata](#gear-metadata)
-- [ControllerRecord](#gear-controllerrecord)
-- [Controllers](#gear-controllers)
+- [AccessKeyRecord](#gear-accesskeyrecord)
+- [AccessKeys](#gear-accesskeys)
 - [ListStoreParams](#gear-liststoreparams)
 - [GetDocStoreParams](#gear-getdocstoreparams)
 - [SetDocStoreParams](#gear-setdocstoreparams)
@@ -2940,17 +2883,7 @@ Represents a raw principal - a Uint8Array representation of a Principal.
 | -------------- | ------------ |
 | `RawPrincipal` | `Uint8Array` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/candid.ts#L20)
-
-#### :gear: Principal
-
-Represents a principal - i.e. an object instantiated with the class Principal.
-
-| Type        | Type                              |
-| ----------- | --------------------------------- |
-| `Principal` | `z.infer<typeof PrincipalSchema>` |
-
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/candid.ts#L30)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/principal.ts#L11)
 
 #### :gear: Timestamp
 
@@ -2962,7 +2895,7 @@ Used for tracking when events occur, such as document creation and updates.
 | ----------- | --------------------------------- |
 | `Timestamp` | `z.infer<typeof TimestampSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L14)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L15)
 
 #### :gear: Version
 
@@ -2974,7 +2907,7 @@ This is typically incremented with each update to ensure consistency.
 | --------- | ------------------------------- |
 | `Version` | `z.infer<typeof VersionSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L26)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L27)
 
 #### :gear: RawUserId
 
@@ -2986,7 +2919,7 @@ This is a principal associated with a user.
 | ----------- | -------------- |
 | `RawUserId` | `RawPrincipal` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L38)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L39)
 
 #### :gear: UserId
 
@@ -2998,7 +2931,7 @@ This is a principal associated with a user.
 | -------- | ------------------------------ |
 | `UserId` | `z.infer<typeof UserIdSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L50)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L51)
 
 #### :gear: Collection
 
@@ -3008,7 +2941,7 @@ A collection name where data are stored.
 | ------------ | ---------------------------------- |
 | `Collection` | `z.infer<typeof CollectionSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L60)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L61)
 
 #### :gear: Key
 
@@ -3018,7 +2951,7 @@ A key identifier within a collection.
 | ----- | --------------------------- |
 | `Key` | `z.infer<typeof KeySchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L70)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L71)
 
 #### :gear: Description
 
@@ -3029,7 +2962,7 @@ Used for document and asset fields which can be useful for search purpose.
 | ------------- | ----------------------------------- |
 | `Description` | `z.infer<typeof DescriptionSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L81)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/satellite.ts#L82)
 
 #### :gear: AssertFunction
 
@@ -3610,25 +3543,25 @@ Enum representing possible fields to order by.
 
 [:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/schemas/list.ts#L80)
 
-#### :gear: ControllerScope
+#### :gear: AccessKeyScope
 
-Represents the permission scope of a controller.
+Represents the permission scope of an access key.
 
-| Type              | Type                                    |
-| ----------------- | --------------------------------------- |
-| `ControllerScope` | `z.infer<typeof ControllerScopeSchema>` |
+| Type             | Type                                   |
+| ---------------- | -------------------------------------- |
+| `AccessKeyScope` | `z.infer<typeof AccessKeyScopeSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L20)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L13)
 
-#### :gear: ControllerKind
+#### :gear: AccessKeyKind
 
-Represents a specific kind of controller. Meant for informational purposes.
+Represents a specific kind of access key. Meant for informational purposes.
 
-| Type             | Type                                   |
-| ---------------- | -------------------------------------- |
-| `ControllerKind` | `z.infer<typeof ControllerKindSchema>` |
+| Type            | Type                                  |
+| --------------- | ------------------------------------- |
+| `AccessKeyKind` | `z.infer<typeof AccessKeyKindSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L30)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L23)
 
 #### :gear: Metadata
 
@@ -3638,27 +3571,27 @@ Represents a single metadata entry as a key-value tuple.
 | ---------- | -------------------------------- |
 | `Metadata` | `z.infer<typeof MetadataSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L40)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L33)
 
-#### :gear: ControllerRecord
+#### :gear: AccessKeyRecord
 
-Represents a tuple containing the principal ID and associated controller data.
+Represents a tuple containing the principal ID and associated access key data.
 
-| Type               | Type                                     |
-| ------------------ | ---------------------------------------- |
-| `ControllerRecord` | `z.infer<typeof ControllerRecordSchema>` |
+| Type              | Type                                    |
+| ----------------- | --------------------------------------- |
+| `AccessKeyRecord` | `z.infer<typeof AccessKeyRecordSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L99)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L92)
 
-#### :gear: Controllers
+#### :gear: AccessKeys
 
-Represents a list of controllers.
+Represents a list of access keys.
 
-| Type          | Type                                |
-| ------------- | ----------------------------------- |
-| `Controllers` | `z.infer<typeof ControllersSchema>` |
+| Type         | Type                               |
+| ------------ | ---------------------------------- |
+| `AccessKeys` | `z.infer<typeof AccessKeysSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/controllers.ts#L109)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/sdk/schemas/accessKeys.ts#L102)
 
 #### :gear: ListStoreParams
 
@@ -3854,7 +3787,7 @@ Custom validation function to verify if a value is an instance of `IDL.Type` fro
 | --------- | ------------------------------- |
 | `IDLType` | `z.infer<typeof IDLTypeSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L16)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L17)
 
 #### :gear: CallArg
 
@@ -3864,7 +3797,7 @@ A call argument consisting of its IDL type and corresponding value.
 | --------- | ------------------------------- |
 | `CallArg` | `z.infer<typeof CallArgSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L26)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L27)
 
 #### :gear: CallArgs
 
@@ -3880,7 +3813,7 @@ The order of arguments is preserved for the function call.
 | ---------- | -------------------------------- |
 | `CallArgs` | `z.infer<typeof CallArgsSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L44)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L45)
 
 #### :gear: CallResult
 
@@ -3890,7 +3823,7 @@ Defines the type used to decode the result of a canister call.
 | ------------ | ---------------------------------- |
 | `CallResult` | `z.infer<typeof CallResultSchema>` |
 
-[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L54)
+[:link: Source](https://github.com/junobuild/juno-js/tree/main/packages/functions/src/ic-cdk/schemas/call.ts#L55)
 
 <!-- TSDOC_END -->