@junobuild/functions 0.0.12 → 0.0.13-next-2025-04-01

package/sdk/schemas/db.d.ts

@@ -1,101 +1,59 @@
 import * as z from 'zod';
+import { type DelDoc, type SetDoc } from '../../schemas/db';
+import { type Collection, type Key, type RawUserId, type UserId } from '../../schemas/satellite';
 /**
- * @see SetDoc
+ * Represents the base parameters required to access the datastore and modify a document.
  */
-export declare const SetDocSchema: z.ZodObject<{
+export interface DocStoreParams {
     /**
-     * The unique key identifying the document within the collection.
-     */
-    key: z.ZodString;
-    /**
-     * An optional description of the document.
+     * The caller who initiate the document operation.
      */
-    description: z.ZodOptional<z.ZodString>;
+    caller: RawUserId | UserId;
     /**
-     * The raw data of the document.
+     * The name of the collection where the document is stored.
      */
-    data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
+    collection: Collection;
     /**
-     * The expected version number to ensure consistency.
-     * If provided, the operation will fail if the stored version does not match.
+     * The unique key identifying the document within the collection.
      */
-    version: z.ZodOptional<z.ZodBigInt>;
-}, "strict", z.ZodTypeAny, {
-    data: Uint8Array<ArrayBufferLike>;
-    key: string;
-    description?: string | undefined;
-    version?: bigint | undefined;
-}, {
-    data: Uint8Array<ArrayBufferLike>;
-    key: string;
-    description?: string | undefined;
-    version?: bigint | undefined;
-}>;
-/**
- * Represents a request to set or update a document.
- *
- * This is used when submitting new document data.
- */
-export type SetDoc = z.infer<typeof SetDocSchema>;
+    key: Key;
+}
 /**
  * @see SetDocStoreParams
  */
-export declare const SetDocStoreParamsSchema: z.ZodObject<{
-    /**
-     * The caller who initiate the document operation.
-     */
+export declare const SetDocStoreParamsSchema: z.ZodObject<z.objectUtil.extendShape<{
     caller: z.ZodUnion<[z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>, z.ZodType<import("@dfinity/principal").Principal, z.ZodTypeDef, import("@dfinity/principal").Principal>]>;
-    /**
-     * The name of the collection where the document is stored.
-     */
     collection: z.ZodString;
-    /**
-     * The data, key and other information required to create or update a document.
-     */
+    key: z.ZodString;
+}, {
     doc: z.ZodObject<{
-        /**
-         * The unique key identifying the document within the collection.
-         */
-        key: z.ZodString;
-        /**
-         * An optional description of the document.
-         */
-        description: z.ZodOptional<z.ZodString>;
-        /**
-         * The raw data of the document.
-         */
         data: z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>;
-        /**
-         * The expected version number to ensure consistency.
-         * If provided, the operation will fail if the stored version does not match.
-         */
+        description: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodBigInt>;
     }, "strict", z.ZodTypeAny, {
         data: Uint8Array<ArrayBufferLike>;
-        key: string;
         description?: string | undefined;
         version?: bigint | undefined;
     }, {
         data: Uint8Array<ArrayBufferLike>;
-        key: string;
         description?: string | undefined;
         version?: bigint | undefined;
     }>;
-}, "strict", z.ZodTypeAny, {
+}>, "strict", z.ZodTypeAny, {
     caller: Uint8Array<ArrayBufferLike> | import("@dfinity/principal").Principal;
     collection: string;
+    key: string;
     doc: {
         data: Uint8Array<ArrayBufferLike>;
-        key: string;
         description?: string | undefined;
         version?: bigint | undefined;
     };
 }, {
     caller: Uint8Array<ArrayBufferLike> | import("@dfinity/principal").Principal;
     collection: string;
+    key: string;
     doc: {
         data: Uint8Array<ArrayBufferLike>;
-        key: string;
         description?: string | undefined;
         version?: bigint | undefined;
     };
@@ -106,4 +64,51 @@ export declare const SetDocStoreParamsSchema: z.ZodObject<{
  * This includes the document data along with metadata such as the caller,
  * collection, and key.
  */
-export type SetDocStoreParams = z.infer<typeof SetDocStoreParamsSchema>;
+export type SetDocStoreParams = DocStoreParams & {
+    /**
+     * The data, optional description and version required to create or update a document.
+     */
+    doc: SetDoc;
+};
+/**
+ * @see DeleteDocStoreParams
+ */
+export declare const DeleteDocStoreParamsSchema: z.ZodObject<z.objectUtil.extendShape<{
+    caller: z.ZodUnion<[z.ZodType<Uint8Array<ArrayBufferLike>, z.ZodTypeDef, Uint8Array<ArrayBufferLike>>, z.ZodType<import("@dfinity/principal").Principal, z.ZodTypeDef, import("@dfinity/principal").Principal>]>;
+    collection: z.ZodString;
+    key: z.ZodString;
+}, {
+    doc: z.ZodObject<{
+        version: z.ZodOptional<z.ZodBigInt>;
+    }, "strict", z.ZodTypeAny, {
+        version?: bigint | undefined;
+    }, {
+        version?: bigint | undefined;
+    }>;
+}>, "strict", z.ZodTypeAny, {
+    caller: Uint8Array<ArrayBufferLike> | import("@dfinity/principal").Principal;
+    collection: string;
+    key: string;
+    doc: {
+        version?: bigint | undefined;
+    };
+}, {
+    caller: Uint8Array<ArrayBufferLike> | import("@dfinity/principal").Principal;
+    collection: string;
+    key: string;
+    doc: {
+        version?: bigint | undefined;
+    };
+}>;
+/**
+ * Represents the parameters required to delete a document.
+ *
+ * This includes the document version along with metadata such as the caller,
+ * collection, and key.
+ */
+export type DeleteDocStoreParams = DocStoreParams & {
+    /**
+     * The version required to delete a document.
+     */
+    doc: DelDoc;
+};

package/sdk/utils/caller.utils.d.ts

@@ -0,0 +1,10 @@
+import { RawUserId, UserId } from '../../schemas/satellite';
+/**
+ * Normalizes a user ID into a raw `Uint8Array` representation.
+ *
+ * @param {RawUserId | UserId} caller - The caller identity, either a raw `Uint8Array`
+ * or a `Principal` instance.
+ *
+ * @returns {RawUserId} The raw user ID as a `Uint8Array`.
+ */
+export declare const normalizeCaller: (caller: RawUserId | UserId) => RawUserId;

package/sdk.d.ts

@@ -1,3 +1,5 @@
+export * from './sdk/controllers.sdk';
 export * from './sdk/db.sdk';
+export * from './sdk/schemas/controllers';
 export * from './sdk/schemas/db';
 export * from './sdk/serializer.sdk';

package/sdk.js

@@ -1,2 +1,2 @@
-import{b as a,c as r,d as c,e as s,f as m,g as i,h as n}from"./chunk-LVVTFR6B.js";import"./chunk-CCKUQNB5.js";import{Principal as h}from"@dfinity/principal";import*as e from"zod";var f=e.object({key:m,description:i.optional(),data:n,version:a.optional()}).strict(),p=e.object({caller:r.or(c),collection:s,doc:f}).strict();var T=o=>{p.parse(o);let{caller:t,collection:S,doc:l}=o,{key:_,...D}=l,d=t instanceof h?t.toUint8Array():t;__juno_satellite_datastore_set_doc_store(d,S,_,D)};import{jsonReplacer as x,jsonReviver as y}from"@dfinity/utils";var U=o=>JSON.parse(__juno_satellite_datastore_raw_data_to_text(o),y),k=o=>__juno_satellite_datastore_raw_data_from_text(JSON.stringify(o,x));export{f as SetDocSchema,p as SetDocStoreParamsSchema,U as decodeDocData,k as encodeDocData,T as setDocStore};
+import{a as c,c as s,d as n,e as _,f as S,k as C,l as x}from"./chunk-6G6FWQ45.js";import{b as d}from"./chunk-CCKUQNB5.js";import*as o from"zod";var P=o.enum(["write","admin"]),z=o.tuple([o.string(),o.string()]),R=o.object({metadata:o.array(z),created_at:c,updated_at:c,expires_at:c.optional(),scope:P}).strict(),U=o.tuple([d,R]),I=o.array(U),i=o.object({caller:s.or(n),controllers:I});import{Principal as w}from"@dfinity/principal";var l=e=>e instanceof w?e.toUint8Array():e;var B=()=>__juno_satellite_datastore_get_admin_controllers(),E=()=>__juno_satellite_datastore_get_controllers(),F=e=>{i.parse(e);let{caller:t,controllers:r}=e,a=l(t);return __juno_satellite_datastore_is_admin_controller(a,r)},G=e=>{i.parse(e);let{caller:t,controllers:r}=e,a=l(t);return __juno_satellite_datastore_is_controller(a,r)};import*as D from"zod";var f=D.object({caller:s.or(n),collection:_,key:S}),h=f.extend({doc:C}).strict(),y=f.extend({doc:x}).strict();var $=e=>{h.parse(e);let{caller:t,collection:r,key:a,doc:m}=e,p=l(t);__juno_satellite_datastore_set_doc_store(p,r,a,m)},ee=e=>{y.parse(e);let{caller:t,collection:r,key:a,doc:m}=e,p=l(t);__juno_satellite_datastore_delete_doc_store(p,r,a,m)};import{jsonReplacer as u,jsonReviver as j}from"@dfinity/utils";var re=e=>JSON.parse(__juno_satellite_datastore_raw_data_to_text(e),j),ae=e=>__juno_satellite_datastore_raw_data_from_text(JSON.stringify(e,u));export{i as ControllerCheckParamsSchema,U as ControllerRecordSchema,R as ControllerSchema,P as ControllerScopeSchema,I as ControllersSchema,y as DeleteDocStoreParamsSchema,z as MetadataSchema,h as SetDocStoreParamsSchema,re as decodeDocData,ee as deleteDocStore,ae as encodeDocData,B as getAdminControllers,E as getControllers,F as isAdminController,G as isController,$ as setDocStore};
 //# sourceMappingURL=sdk.js.map

package/sdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["src/sdk/db.sdk.ts", "src/sdk/schemas/db.ts", "src/sdk/serializer.sdk.ts"],
-  "sourcesContent": ["import {Principal} from '@dfinity/principal';\nimport {SetDocStoreParams, SetDocStoreParamsSchema} from './schemas/db';\n\n/**\n * Stores or updates a document in the datastore.\n *\n * The data must have been encoded - using encodeDocData - before calling this function.\n *\n * @param {SetDocStoreParams} params - The parameters required to store the document,\n * including the caller, collection, key, and document data.\n *\n * @throws {z.ZodError} If the provided parameters do not match the expected schema.\n * @throws {Error} If the Satellite fails at validating the submitted document before storing it.\n */\nexport const setDocStore = (params: SetDocStoreParams) => {\n  SetDocStoreParamsSchema.parse(params);\n\n  const {caller: providedCaller, collection, doc} = params;\n\n  const {key, ...setDoc} = doc;\n\n  const caller =\n    providedCaller instanceof Principal ? providedCaller.toUint8Array() : providedCaller;\n\n  __juno_satellite_datastore_set_doc_store(caller, collection, key, setDoc);\n};\n", "import * as z from 'zod';\nimport {DocDescriptionSchema, RawDataSchema} from '../../schemas/db';\nimport {\n  CollectionSchema,\n  KeySchema,\n  RawUserIdSchema,\n  UserIdSchema,\n  VersionSchema\n} from '../../schemas/satellite';\n\n/**\n * @see SetDoc\n */\nexport const SetDocSchema = z\n  .object({\n    /**\n     * The unique key identifying the document within the collection.\n     */\n    key: KeySchema,\n\n    /**\n     * An optional description of the document.\n     */\n    description: DocDescriptionSchema.optional(),\n\n    /**\n     * The raw data of the document.\n     */\n    data: RawDataSchema,\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\n/**\n * @see SetDocStoreParams\n */\nexport const SetDocStoreParamsSchema = z\n  .object({\n    /**\n     * The caller who initiate the document operation.\n     */\n    caller: RawUserIdSchema.or(UserIdSchema),\n\n    /**\n     * The name of the collection where the document is stored.\n     */\n    collection: CollectionSchema,\n\n    /**\n     * The data, key and other information required to create or update a document.\n     */\n    doc: SetDocSchema\n  })\n  .strict();\n\n/**\n * Represents the parameters required to store or update a document.\n *\n * This includes the document data along with metadata such as the caller,\n * collection, and key.\n */\nexport type SetDocStoreParams = z.infer<typeof SetDocStoreParamsSchema>;\n", "import {jsonReplacer, jsonReviver} from '@dfinity/utils';\nimport type {RawData} from '../schemas/db';\n\n/**\n * Decodes the raw data of a document into a JavaScript object.\n *\n * @template T The expected type of the decoded object.\n * @param {RawData} data - The raw data to be decoded.\n * @returns {T} The parsed JavaScript object.\n */\nexport const decodeDocData = <T>(data: RawData): T =>\n  JSON.parse(__juno_satellite_datastore_raw_data_to_text(data), jsonReviver);\n\n/**\n * Encodes a JavaScript object into a raw data format to be applied to a document.\n *\n * @template T The type of the object to be encoded.\n * @param {T} data - The data to be encoded.\n * @returns {RawData} The serialized raw data.\n */\nexport const encodeDocData = <T>(data: T): RawData =>\n  __juno_satellite_datastore_raw_data_from_text(JSON.stringify(data, jsonReplacer));\n"],
-  "mappings": "8GAAA,OAAQ,aAAAA,MAAgB,qBCAxB,UAAYC,MAAO,MAaZ,IAAMC,EACV,SAAO,CAIN,IAAKC,EAKL,YAAaC,EAAqB,SAAS,EAK3C,KAAMC,EAMN,QAASC,EAAc,SAAS,CAClC,CAAC,EACA,OAAO,EAYGC,EACV,SAAO,CAIN,OAAQC,EAAgB,GAAGC,CAAY,EAKvC,WAAYC,EAKZ,IAAKR,CACP,CAAC,EACA,OAAO,EDnDH,IAAMS,EAAeC,GAA8B,CACxDC,EAAwB,MAAMD,CAAM,EAEpC,GAAM,CAAC,OAAQE,EAAgB,WAAAC,EAAY,IAAAC,CAAG,EAAIJ,EAE5C,CAAC,IAAAK,EAAK,GAAGC,CAAM,EAAIF,EAEnBG,EACJL,aAA0BM,EAAYN,EAAe,aAAa,EAAIA,EAExE,yCAAyCK,EAAQJ,EAAYE,EAAKC,CAAM,CAC1E,EEzBA,OAAQ,gBAAAG,EAAc,eAAAC,MAAkB,iBAUjC,IAAMC,EAAoBC,GAC/B,KAAK,MAAM,4CAA4CA,CAAI,EAAGF,CAAW,EAS9DG,EAAoBD,GAC/B,8CAA8C,KAAK,UAAUA,EAAMH,CAAY,CAAC",
-  "names": ["Principal", "z", "SetDocSchema", "KeySchema", "DocDescriptionSchema", "RawDataSchema", "VersionSchema", "SetDocStoreParamsSchema", "RawUserIdSchema", "UserIdSchema", "CollectionSchema", "setDocStore", "params", "SetDocStoreParamsSchema", "providedCaller", "collection", "doc", "key", "setDoc", "caller", "Principal", "jsonReplacer", "jsonReviver", "decodeDocData", "data", "encodeDocData"]
+  "sources": ["src/sdk/schemas/controllers.ts", "src/sdk/utils/caller.utils.ts", "src/sdk/controllers.sdk.ts", "src/sdk/schemas/db.ts", "src/sdk/db.sdk.ts", "src/sdk/serializer.sdk.ts"],
+  "sourcesContent": ["import * as z from 'zod';\nimport {RawPrincipalSchema} from '../../schemas/candid';\nimport {\n  RawUserId,\n  RawUserIdSchema,\n  Timestamp,\n  TimestampSchema,\n  UserId,\n  UserIdSchema\n} from '../../schemas/satellite';\n\n/**\n * @see ControllerScopeSchema\n */\nexport const ControllerScopeSchema = z.enum(['write', 'admin']);\n\n/**\n * Represents the permission scope of a controller.\n */\nexport type ControllerScope = z.infer<typeof ControllerScopeSchema>;\n\n/**\n * @see MetadataSchema\n */\nexport const MetadataSchema = z.tuple([z.string(), z.string()]);\n\n/**\n * Represents a single metadata entry as a key-value tuple.\n */\nexport type Metadata = z.infer<typeof MetadataSchema>;\n\n/**\n * @see ControllerSchema\n */\nexport const ControllerSchema = z\n  .object({\n    metadata: z.array(MetadataSchema),\n    created_at: TimestampSchema,\n    updated_at: TimestampSchema,\n    expires_at: TimestampSchema.optional(),\n    scope: ControllerScopeSchema\n  })\n  .strict();\n\n/**\n * Represents a controller with access scope and associated metadata.\n */\nexport interface Controller {\n  /**\n   * A list of key-value metadata pairs associated with the controller.\n   */\n  metadata: Metadata[];\n\n  /**\n   * The timestamp when the controller was created.\n   */\n  created_at: Timestamp;\n\n  /**\n   * The timestamp when the controller was last updated.\n   */\n  updated_at: Timestamp;\n\n  /**\n   * Optional expiration timestamp for the controller.\n   * \uD83D\uDC49 It's a placeholder for future implementation.\n   */\n  expires_at?: Timestamp;\n\n  /**\n   * The scope assigned to the controller.\n   */\n  scope: ControllerScope;\n}\n\n/**\n * @see ControllerRecordSchema\n */\nexport const ControllerRecordSchema = z.tuple([RawPrincipalSchema, ControllerSchema]);\n\n/**\n * Represents a tuple containing the principal ID and associated controller data.\n */\nexport type ControllerRecord = z.infer<typeof ControllerRecordSchema>;\n\n/**\n * @see ControllersSchema\n */\nexport const ControllersSchema = z.array(ControllerRecordSchema);\n\n/**\n * Represents a list of controllers.\n */\nexport type Controllers = z.infer<typeof ControllersSchema>;\n\n/**\n * @see ControllerCheckParamsSchema\n */\nexport const ControllerCheckParamsSchema = z.object({\n  caller: RawUserIdSchema.or(UserIdSchema),\n  controllers: ControllersSchema\n});\n\n/**\n * Represents the parameters required to perform controller checks.\n */\nexport interface ControllerCheckParams {\n  /**\n   * The identity of the caller to verify against the controller list.\n   */\n  caller: RawUserId | UserId;\n\n  /**\n   * The list of controllers to check against.\n   */\n  controllers: Controllers;\n}\n", "import {Principal} from '@dfinity/principal';\nimport {RawUserId, UserId} from '../../schemas/satellite';\n\n/**\n * Normalizes a user ID into a raw `Uint8Array` representation.\n *\n * @param {RawUserId | UserId} caller - The caller identity, either a raw `Uint8Array`\n * or a `Principal` instance.\n *\n * @returns {RawUserId} The raw user ID as a `Uint8Array`.\n */\nexport const normalizeCaller = (caller: RawUserId | UserId): RawUserId => caller instanceof Principal ? caller.toUint8Array() : caller;\n", "import {\n  ControllerCheckParams,\n  ControllerCheckParamsSchema,\n  Controllers\n} from './schemas/controllers';\nimport {normalizeCaller} from './utils/caller.utils';\n\n/**\n * Gets the list of admin controllers from the Satellite.\n *\n * @returns {Controllers} The list of admin controllers.\n *\n * @throws {z.ZodError} If the returned value does not match the expected schema.\n */\nexport const getAdminControllers = (): Controllers =>\n  __juno_satellite_datastore_get_admin_controllers();\n\n/**\n * Gets the list of controllers from the Satellite.\n *\n * @returns {Controllers} The list of all controllers.\n *\n * @throws {z.ZodError} If the returned value does not match the expected schema.\n */\nexport const getControllers = (): Controllers => __juno_satellite_datastore_get_controllers();\n\n/**\n * Checks if the given caller is an admin among the provided controllers.\n *\n * @param {ControllerCheckParams} params - The parameters including the caller identity\n * and the list of controllers to verify against.\n *\n * @returns {boolean} Whether the caller is an admin.\n *\n * @throws {z.ZodError} If any input does not match the expected schema.\n */\nexport const isAdminController = (params: ControllerCheckParams): boolean => {\n  ControllerCheckParamsSchema.parse(params);\n\n  const {caller: providedCaller, controllers} = params;\n\n  const caller = normalizeCaller(providedCaller);\n\n  return __juno_satellite_datastore_is_admin_controller(caller, controllers);\n};\n\n/**\n * Checks if the given caller exists among the provided controllers.\n *\n * @param {ControllerCheckParams} params - The parameters including the caller identity\n * and the list of controllers to verify against.\n *\n * @returns {boolean} Whether the caller is a controller.\n *\n * @throws {z.ZodError} If any input does not match the expected schema.\n */\nexport const isController = (params: ControllerCheckParams): boolean => {\n  ControllerCheckParamsSchema.parse(params);\n\n  const {caller: providedCaller, controllers} = params;\n\n  const caller = normalizeCaller(providedCaller);\n\n  return __juno_satellite_datastore_is_controller(caller, controllers);\n};\n", "import * as z from 'zod';\nimport {type DelDoc, DelDocSchema, type SetDoc, SetDocSchema} from '../../schemas/db';\nimport {\n  type Collection,\n  CollectionSchema,\n  type Key,\n  KeySchema,\n  type RawUserId,\n  RawUserIdSchema,\n  type UserId,\n  UserIdSchema\n} from '../../schemas/satellite';\n\n/**\n * @see DocStoreParams\n */\nconst DocStoreParamsSchema = z.object({\n  caller: RawUserIdSchema.or(UserIdSchema),\n  collection: CollectionSchema,\n  key: KeySchema\n});\n\n/**\n * Represents the base parameters required to access the datastore and modify a document.\n */\nexport interface DocStoreParams {\n  /**\n   * The caller who initiate the document operation.\n   */\n  caller: RawUserId | UserId;\n\n  /**\n   * The name of the collection where the document is stored.\n   */\n  collection: Collection;\n\n  /**\n   * The unique key identifying the document within the collection.\n   */\n  key: Key;\n}\n\n/**\n * @see SetDocStoreParams\n */\nexport const SetDocStoreParamsSchema = DocStoreParamsSchema.extend({\n  doc: SetDocSchema\n}).strict();\n\n/**\n * Represents the parameters required to store or update a document.\n *\n * This includes the document data along with metadata such as the caller,\n * collection, and key.\n */\nexport type SetDocStoreParams = DocStoreParams & {\n  /**\n   * The data, optional description and version required to create or update a document.\n   */\n  doc: SetDoc;\n};\n\n/**\n * @see DeleteDocStoreParams\n */\nexport const DeleteDocStoreParamsSchema = DocStoreParamsSchema.extend({\n  doc: DelDocSchema\n}).strict();\n\n/**\n * Represents the parameters required to delete a document.\n *\n * This includes the document version along with metadata such as the caller,\n * collection, and key.\n */\nexport type DeleteDocStoreParams = DocStoreParams & {\n  /**\n   * The version required to delete a document.\n   */\n  doc: DelDoc;\n};\n", "import {\n  DeleteDocStoreParams,\n  DeleteDocStoreParamsSchema,\n  SetDocStoreParams,\n  SetDocStoreParamsSchema\n} from './schemas/db';\nimport {normalizeCaller} from './utils/caller.utils';\n\n/**\n * Stores or updates a document in the datastore.\n *\n * The data must have been encoded - using encodeDocData - before calling this function.\n *\n * @param {SetDocStoreParams} params - The parameters required to store the document,\n * including the caller, collection, key, and document data.\n *\n * @throws {z.ZodError} If the provided parameters do not match the expected schema.\n * @throws {Error} If the Satellite fails at validating the submitted document before storing it.\n */\nexport const setDocStore = (params: SetDocStoreParams) => {\n  SetDocStoreParamsSchema.parse(params);\n\n  const {caller: providedCaller, collection, key, doc} = params;\n\n  const caller = normalizeCaller(providedCaller);\n\n  __juno_satellite_datastore_set_doc_store(caller, collection, key, doc);\n};\n\n/**\n * Delete a document in the datastore.\n *\n * @param {DeleteDocStoreParams} params - The parameters required to delete the document,\n * including the caller, collection, key, and version of the document.\n *\n * @throws {z.ZodError} If the provided parameters do not match the expected schema.\n * @throws {Error} If the Satellite fails at validating the submitted request before deleting it.\n */\nexport const deleteDocStore = (params: DeleteDocStoreParams) => {\n  DeleteDocStoreParamsSchema.parse(params);\n\n  const {caller: providedCaller, collection, key, doc} = params;\n\n  const caller = normalizeCaller(providedCaller);\n\n  __juno_satellite_datastore_delete_doc_store(caller, collection, key, doc);\n};\n", "import {jsonReplacer, jsonReviver} from '@dfinity/utils';\nimport type {RawData} from '../schemas/db';\n\n/**\n * Decodes the raw data of a document into a JavaScript object.\n *\n * @template T The expected type of the decoded object.\n * @param {RawData} data - The raw data to be decoded.\n * @returns {T} The parsed JavaScript object.\n */\nexport const decodeDocData = <T>(data: RawData): T =>\n  JSON.parse(__juno_satellite_datastore_raw_data_to_text(data), jsonReviver);\n\n/**\n * Encodes a JavaScript object into a raw data format to be applied to a document.\n *\n * @template T The type of the object to be encoded.\n * @param {T} data - The data to be encoded.\n * @returns {RawData} The serialized raw data.\n */\nexport const encodeDocData = <T>(data: T): RawData =>\n  __juno_satellite_datastore_raw_data_from_text(JSON.stringify(data, jsonReplacer));\n"],
+  "mappings": "0HAAA,UAAYA,MAAO,MAcZ,IAAMC,EAA0B,OAAK,CAAC,QAAS,OAAO,CAAC,EAUjDC,EAAmB,QAAM,CAAG,SAAO,EAAK,SAAO,CAAC,CAAC,EAUjDC,EACV,SAAO,CACN,SAAY,QAAMD,CAAc,EAChC,WAAYE,EACZ,WAAYA,EACZ,WAAYA,EAAgB,SAAS,EACrC,MAAOH,CACT,CAAC,EACA,OAAO,EAoCGI,EAA2B,QAAM,CAACC,EAAoBH,CAAgB,CAAC,EAUvEI,EAAsB,QAAMF,CAAsB,EAUlDG,EAAgC,SAAO,CAClD,OAAQC,EAAgB,GAAGC,CAAY,EACvC,YAAaH,CACf,CAAC,ECrGD,OAAQ,aAAAI,MAAgB,qBAWjB,IAAMC,EAAmBC,GAA0CA,aAAkBF,EAAYE,EAAO,aAAa,EAAIA,ECGzH,IAAMC,EAAsB,IACjC,iDAAiD,EAStCC,EAAiB,IAAmB,2CAA2C,EAY/EC,EAAqBC,GAA2C,CAC3EC,EAA4B,MAAMD,CAAM,EAExC,GAAM,CAAC,OAAQE,EAAgB,YAAAC,CAAW,EAAIH,EAExCI,EAASC,EAAgBH,CAAc,EAE7C,OAAO,+CAA+CE,EAAQD,CAAW,CAC3E,EAYaG,EAAgBN,GAA2C,CACtEC,EAA4B,MAAMD,CAAM,EAExC,GAAM,CAAC,OAAQE,EAAgB,YAAAC,CAAW,EAAIH,EAExCI,EAASC,EAAgBH,CAAc,EAE7C,OAAO,yCAAyCE,EAAQD,CAAW,CACrE,EChEA,UAAYI,MAAO,MAgBnB,IAAMC,EAAyB,SAAO,CACpC,OAAQC,EAAgB,GAAGC,CAAY,EACvC,WAAYC,EACZ,IAAKC,CACP,CAAC,EAyBYC,EAA0BL,EAAqB,OAAO,CACjE,IAAKM,CACP,CAAC,EAAE,OAAO,EAkBGC,EAA6BP,EAAqB,OAAO,CACpE,IAAKQ,CACP,CAAC,EAAE,OAAO,EChDH,IAAMC,EAAeC,GAA8B,CACxDC,EAAwB,MAAMD,CAAM,EAEpC,GAAM,CAAC,OAAQE,EAAgB,WAAAC,EAAY,IAAAC,EAAK,IAAAC,CAAG,EAAIL,EAEjDM,EAASC,EAAgBL,CAAc,EAE7C,yCAAyCI,EAAQH,EAAYC,EAAKC,CAAG,CACvE,EAWaG,GAAkBR,GAAiC,CAC9DS,EAA2B,MAAMT,CAAM,EAEvC,GAAM,CAAC,OAAQE,EAAgB,WAAAC,EAAY,IAAAC,EAAK,IAAAC,CAAG,EAAIL,EAEjDM,EAASC,EAAgBL,CAAc,EAE7C,4CAA4CI,EAAQH,EAAYC,EAAKC,CAAG,CAC1E,EC9CA,OAAQ,gBAAAK,EAAc,eAAAC,MAAkB,iBAUjC,IAAMC,GAAoBC,GAC/B,KAAK,MAAM,4CAA4CA,CAAI,EAAGF,CAAW,EAS9DG,GAAoBD,GAC/B,8CAA8C,KAAK,UAAUA,EAAMH,CAAY,CAAC",
+  "names": ["z", "ControllerScopeSchema", "MetadataSchema", "ControllerSchema", "TimestampSchema", "ControllerRecordSchema", "RawPrincipalSchema", "ControllersSchema", "ControllerCheckParamsSchema", "RawUserIdSchema", "UserIdSchema", "Principal", "normalizeCaller", "caller", "getAdminControllers", "getControllers", "isAdminController", "params", "ControllerCheckParamsSchema", "providedCaller", "controllers", "caller", "normalizeCaller", "isController", "z", "DocStoreParamsSchema", "RawUserIdSchema", "UserIdSchema", "CollectionSchema", "KeySchema", "SetDocStoreParamsSchema", "SetDocSchema", "DeleteDocStoreParamsSchema", "DelDocSchema", "setDocStore", "params", "SetDocStoreParamsSchema", "providedCaller", "collection", "key", "doc", "caller", "normalizeCaller", "deleteDocStore", "DeleteDocStoreParamsSchema", "jsonReplacer", "jsonReviver", "decodeDocData", "data", "encodeDocData"]
 }

package/src/global.d.ts

@@ -1,16 +1,33 @@
-import {RawData} from './schemas/db';
-import type {RawPrincipal, RawUserId} from './schemas/satellite';
-import type {SetDoc} from './sdk/schemas/db';
+import type {DelDoc, RawData, SetDoc} from './schemas/db';
+import type {Collection, Key, RawPrincipal, RawUserId} from './schemas/satellite';
+import {Controllers} from './sdk/schemas/controllers';
 
 declare global {
   function __juno_satellite_datastore_raw_data_to_text(data: RawData): string;
   function __juno_satellite_datastore_raw_data_from_text(data: string): RawData;
 
+  function __juno_satellite_datastore_get_admin_controllers(): Controllers;
+  function __juno_satellite_datastore_get_controllers(): Controllers;
+  function __juno_satellite_datastore_is_admin_controller(
+    caller: RawUserId,
+    controllers: Controllers
+  ): boolean;
+  function __juno_satellite_datastore_is_controller(
+    caller: RawUserId,
+    controllers: Controllers
+  ): boolean;
+
   function __juno_satellite_datastore_set_doc_store(
     caller: RawUserId,
-    collection: string,
-    key: string,
-    value: Omit<SetDoc, 'key'>
+    collection: Collection,
+    key: Key,
+    value: SetDoc
+  ): void;
+  function __juno_satellite_datastore_delete_doc_store(
+    caller: RawUserId,
+    collection: Collection,
+    key: Key,
+    value: DelDoc
   ): void;
 
   function __ic_cdk_id(): RawPrincipal;

package/tests/mocks/controllers.mocks.d.ts

@@ -0,0 +1,4 @@
+import { Principal } from '@dfinity/principal';
+export declare const mockUserIdText = "xlmdg-vkosz-ceopx-7wtgu-g3xmd-koiyc-awqaq-7modz-zf6r6-364rh-oqe";
+export declare const mockUserIdPrincipal: Principal;
+export declare const mockRawUserId: Uint8Array<ArrayBufferLike>;

package/chunk-LVVTFR6B.js

@@ -1,2 +0,0 @@
-import{a as r,b as a,c as p}from"./chunk-CCKUQNB5.js";import*as e from"zod";var o=e.bigint(),c=e.bigint(),i=a,h=p,S=e.string(),f=e.string();import*as t from"zod";var m=t.string().max(1024),n=r,d=t.object({owner:i,data:n,description:m.optional(),created_at:o,updated_at:o,version:c.optional()}).strict();export{o as a,c as b,i as c,h as d,S as e,f,m as g,n as h,d as i};
-//# sourceMappingURL=chunk-LVVTFR6B.js.map

package/chunk-LVVTFR6B.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["src/schemas/satellite.ts", "src/schemas/db.ts"],
-  "sourcesContent": ["import * as z from 'zod';\nimport {PrincipalSchema, RawPrincipalSchema} from './candid';\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 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\n/**\n * @see UserId\n */\nexport const UserIdSchema = PrincipalSchema;\n\n/**\n * Represents a user identifier.\n *\n * This is a principal associated with a user.\n */\nexport type UserId = z.infer<typeof UserIdSchema>;\n\n/**\n * @see Collection\n */\nexport const CollectionSchema = z.string();\n\n/**\n * A collection name where data are stored.\n */\nexport type Collection = z.infer<typeof CollectionSchema>;\n\n/**\n * @see Key\n */\nexport const KeySchema = z.string();\n\n/**\n * A unique key identifier within a collection.\n */\nexport type Key = z.infer<typeof KeySchema>;\n", "import * as z from 'zod';\nimport {Uint8ArraySchema} from './candid';\nimport {RawUserIdSchema, TimestampSchema, VersionSchema} from './satellite';\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 RawData\n */\nexport const RawDataSchema = Uint8ArraySchema;\n\n/**\n * Represents raw binary data.\n *\n * This is used to store structured data in a document.\n */\nexport type RawData = z.infer<typeof Uint8ArraySchema>;\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"],
-  "mappings": "sDAAA,UAAYA,MAAO,MAMZ,IAAMC,EAAoB,SAAO,EAY3BC,EAAkB,SAAO,EAYzBC,EAAkBC,EAYlBC,EAAeC,EAYfC,EAAqB,SAAO,EAU5BC,EAAc,SAAO,EChElC,UAAYC,MAAO,MAOZ,IAAMC,EAAyB,SAAO,EAAE,IAAI,IAAI,EAU1CC,EAAgBC,EAYhBC,EACV,SAAO,CAIN,MAAOC,EAKP,KAAMH,EAKN,YAAaD,EAAqB,SAAS,EAK3C,WAAYK,EAKZ,WAAYA,EAMZ,QAASC,EAAc,SAAS,CAClC,CAAC,EACA,OAAO",
-  "names": ["z", "TimestampSchema", "VersionSchema", "RawUserIdSchema", "RawPrincipalSchema", "UserIdSchema", "PrincipalSchema", "CollectionSchema", "KeySchema", "z", "DocDescriptionSchema", "RawDataSchema", "Uint8ArraySchema", "DocSchema", "RawUserIdSchema", "TimestampSchema", "VersionSchema"]
-}