@datalayer/core 0.0.1 → 0.0.2

package/lib/models/RolesPlatform.js

@@ -0,0 +1,147 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2021-2024 Datalayer, Inc.
+ *
+ * Datalayer License
+ */
+import { AlienIcon, UserIcon, PersonIcon, PassportControlIcon } from '@datalayer/icons-react';
+const PLATFORM_ANONYMOUS_PERMSSIONS = [
+    "view_landings",
+];
+const PLATFORM_SECURITY_AUDITOR_PERMSSIONS = [
+    "view_landings",
+];
+const PLATFORM_USAGE_REVIEWER_PERMSSIONS = [
+    "view_landings",
+];
+const PLATFORM_FEATURES_PREVIEWER_PERMSSIONS = [
+    "view_landings",
+];
+const PLATFORM_GUEST_PERMSSIONS = PLATFORM_ANONYMOUS_PERMSSIONS.concat(...[
+    "view_users",
+]);
+const PLATFORM_MEMBER_PERMSSIONS = PLATFORM_GUEST_PERMSSIONS.concat(...[
+    "invite_users",
+]);
+const PLATFORM_SUPPORT_MANAGER_PERMSSIONS = PLATFORM_GUEST_PERMSSIONS.concat(...[
+    "invite_users",
+]);
+const PLATFORM_GROWTH_MANAGER_PERMSSIONS = PLATFORM_GUEST_PERMSSIONS.concat(...[
+    "invite_users",
+]);
+const PLATFORM_SUCCESS_MANAGER_PERMSSIONS = PLATFORM_GUEST_PERMSSIONS.concat(...[
+    "invite_users",
+]);
+const PLATFORM_IAM_TOKEN_PERMSSIONS = PLATFORM_MEMBER_PERMSSIONS.concat(...[
+    "invite_users",
+]);
+const PLATFORM_ADMIN_PERMSSIONS = PLATFORM_MEMBER_PERMSSIONS.concat(...[
+    "manage_users",
+]);
+export class PlatformRoles {
+    constructor() { }
+    static Anonymous = {
+        id: 'platform_anonymous',
+        handle: 'platform_anonymous',
+        displayName: 'Platform Anonymous',
+        description: 'A Platform Anonymous is given to an anonymous visitor of the platform who does not have any account.',
+        permissions: PLATFORM_ANONYMOUS_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static Guest = {
+        id: 'platform_guest',
+        handle: 'platform_guest',
+        displayName: 'Platform Guest',
+        description: 'A Platform Guest to an guest of the platform who eg. has requested access to the platform.',
+        permissions: PLATFORM_GUEST_PERMSSIONS,
+        icon: PersonIcon,
+    };
+    static Member = {
+        id: 'platform_member',
+        handle: 'platform_member',
+        displayName: 'Platform Member',
+        description: 'A Platform Member is the role given to any member of the platform.',
+        permissions: PLATFORM_MEMBER_PERMSSIONS,
+        icon: UserIcon,
+    };
+    static IAMToken = {
+        id: 'platform_iam_token',
+        handle: 'platform_iam_token',
+        displayName: 'Platform IAM Token',
+        description: 'A Platform IAM Token.',
+        permissions: PLATFORM_IAM_TOKEN_PERMSSIONS,
+        icon: UserIcon,
+    };
+    static SupportManager = {
+        id: 'platform_support_manager',
+        handle: 'platform_support_manager',
+        displayName: 'Platform Support Manager',
+        description: 'A Platform Support Manager supports users.',
+        permissions: PLATFORM_SUPPORT_MANAGER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static GrowthManager = {
+        id: 'platform_growth_manager',
+        handle: 'platform_growth_manager',
+        displayName: 'Platform Growth Manager',
+        description: 'A Platform Growth Manager growths Datalayer.',
+        permissions: PLATFORM_GROWTH_MANAGER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static SuccessManager = {
+        id: 'platform_success_manager',
+        handle: 'platform_success_manager',
+        displayName: 'Platform Success Manager',
+        description: 'A Platform Success Manager ensures user success.',
+        permissions: PLATFORM_SUCCESS_MANAGER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static SecurityAuditor = {
+        id: 'platform_security_auditor',
+        handle: 'platform_security_auditor',
+        displayName: 'Platform Security Auditor',
+        description: 'A Platform Security Auditor is given to access to create security reviews.',
+        permissions: PLATFORM_SECURITY_AUDITOR_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static FeaturesPreviewer = {
+        id: 'platform_features_previewer',
+        handle: 'platform_features_previewer',
+        displayName: 'Platform Features Previewer',
+        description: 'A Platform Features Previewer can see features before others.',
+        permissions: PLATFORM_FEATURES_PREVIEWER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static UsageReviewer = {
+        id: 'platform_usage_reviewer',
+        handle: 'platform_usage_reviewer',
+        displayName: 'Platform Usage Reviewer',
+        description: 'A Platform Usage Reviewer can review the platform usage.',
+        permissions: PLATFORM_USAGE_REVIEWER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static Admin = {
+        id: 'platform_admin',
+        handle: 'platform_admin',
+        displayName: 'Platform Admin',
+        description: 'A Platform Admin is the administrator of the platform.',
+        permissions: PLATFORM_ADMIN_PERMSSIONS,
+        icon: PassportControlIcon,
+    };
+    static ALL_ROLES = [
+        PlatformRoles.Admin,
+        PlatformRoles.Anonymous,
+        PlatformRoles.FeaturesPreviewer,
+        PlatformRoles.Guest,
+        PlatformRoles.Member,
+        PlatformRoles.IAMToken,
+        PlatformRoles.SecurityAuditor,
+        PlatformRoles.SupportManager,
+        PlatformRoles.GrowthManager,
+        PlatformRoles.SuccessManager,
+        PlatformRoles.UsageReviewer,
+    ];
+}

package/lib/models/RolesTeam.d.ts

@@ -0,0 +1,7 @@
+import { IRole } from "./Role";
+export declare class TeamRoles {
+    private constructor();
+    static readonly Member: IRole;
+    static readonly Owner: IRole;
+    static readonly ALL_ROLES: IRole[];
+}

package/lib/models/RolesTeam.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2021-2024 Datalayer, Inc.
+ *
+ * Datalayer License
+ */
+import { AlienIcon } from '@datalayer/icons-react';
+const TEAM_MEMBER_PERMSSIONS = [
+    "view_team",
+];
+const TEAM_OWNER_PERMSSIONS = TEAM_MEMBER_PERMSSIONS.concat(...[
+    "assign_team_user",
+]);
+export class TeamRoles {
+    constructor() { }
+    static Member = {
+        id: 'team_member',
+        handle: 'team_member',
+        displayName: 'Team Member',
+        description: 'A Team Member is part of a team.',
+        permissions: TEAM_MEMBER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static Owner = {
+        id: 'team_owner',
+        handle: 'team_owner',
+        displayName: 'Team Owner',
+        description: 'A Team Owner can add and remove team members.',
+        permissions: TEAM_OWNER_PERMSSIONS,
+        icon: AlienIcon,
+    };
+    static ALL_ROLES = [
+        TeamRoles.Member,
+        TeamRoles.Owner,
+    ];
+}

package/lib/models/Runtime.d.ts

@@ -0,0 +1,65 @@
+export declare const BACKWARDS_COMPATIBLE_KERNEL_TYPES_MAP: {
+    default: IRuntimeType;
+    snippet: IRuntimeType;
+    notebook: IRuntimeType;
+    cell: IRuntimeType;
+};
+/**
+ * Runtime type.
+ *
+ * TODO refactor with type { RuntimeLocation }
+ */
+export type IRuntimeType = 'notebook' | 'cell';
+/**
+ * Runtime optional capabilities.
+ */
+export type IRuntimeCapabilities = 'user_storage';
+/**
+ * User Kernel Jupyter server metadata
+ */
+export interface IRuntimePod {
+    /**
+     * Environment display name
+     */
+    environment_title: string;
+    /**
+     * Environment name
+     */
+    environment_name: string;
+    /**
+     * Runtime name
+     */
+    pod_name: string;
+    /**
+     * Runtime ingress URL
+     */
+    ingress: string;
+    /**
+     * Runtime user given name
+     */
+    given_name: string;
+    /**
+     * Runtime type
+     */
+    type: IRuntimeType;
+    /**
+     * Server authentication token
+     */
+    token: string;
+    /**
+     * Credits burning rate per second
+     */
+    burning_rate: number;
+    /**
+     * Kernel reservation ID
+     */
+    reservation_id?: string;
+    /**
+     * Runtime usage starting timestamp
+     */
+    started_at: string;
+    /**
+     * Runtime credits reservation expiration timestamp
+     */
+    expired_at?: string;
+}

package/lib/models/Runtime.js

@@ -0,0 +1,16 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2021-2024 Datalayer, Inc.
+ *
+ * Datalayer License
+ */
+export const BACKWARDS_COMPATIBLE_KERNEL_TYPES_MAP = {
+    // Backwards compatible mapping.
+    'default': 'notebook',
+    'snippet': 'cell',
+    'notebook': 'notebook',
+    'cell': 'cell',
+};

package/lib/models/RuntimeSnapshot.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Runtime snapshot from API.
+ */
+export interface IAPIRuntimeSnapshot {
+    /**
+     * Snapshot UID
+     */
+    uid: string;
+    /**
+     * Snapshot name
+     */
+    name: string;
+    /**
+     * Snapshot description
+     */
+    description: string;
+    /**
+     * Snapshot environment
+     */
+    environment: string;
+    /**
+     * Snapshot metadata
+     */
+    metadata: Record<string, any>;
+    /**
+     * Snapshot size in bytes
+     */
+    size: number;
+    /**
+     * Latest update time of the snapshot
+     */
+    updated_at: string;
+    /**
+     * Snapshot format
+     */
+    format: string;
+    /**
+     * Snapshot format version
+     */
+    format_version: string;
+    /**
+     * Snapshot status
+     */
+    status: string;
+}
+/**
+ * Runtime snapshot model.
+ */
+export interface IRuntimeSnapshot {
+    /**
+     * Snapshot UID
+     */
+    id: string;
+    /**
+     * Snapshot name
+     */
+    name: string;
+    /**
+     * Snapshot description
+     */
+    description: string;
+    /**
+     * Snapshot environment
+     */
+    environment: string;
+    /**
+     * Snapshot metadata
+     */
+    metadata: Record<string, any>;
+    /**
+     * Snapshot size in bytes
+     */
+    size: number;
+    /**
+     * Latest update time of the snapshot
+     */
+    updatedAt: Date;
+    /**
+     * Snapshot format
+     */
+    format: string;
+    /**
+     * Snapshot format version
+     */
+    formatVersion: string;
+    /**
+    
+     * Snapshot status
+     */
+    status: string;
+}
+export declare function asRuntimeSnapshot(s: IAPIRuntimeSnapshot): IRuntimeSnapshot;

package/lib/models/RuntimeSnapshot.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export function asRuntimeSnapshot(s) {
+    const { uid, updated_at, format_version, ...others } = s;
+    return {
+        ...others,
+        id: uid,
+        updatedAt: new Date(updated_at),
+        formatVersion: format_version
+    };
+}

package/lib/models/School.d.ts

@@ -0,0 +1,11 @@
+import { IDean } from "./Dean";
+import { IStudent } from "./Student";
+import { ICourse } from "./Course";
+import { IBaseOrganization } from "./Organization";
+export type ISchool = IBaseOrganization & {
+    type: 'school';
+    dean?: IDean;
+    students: Array<IStudent>;
+    courses: Array<ICourse>;
+};
+export default ISchool;

package/lib/models/School.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/Secret.d.ts

@@ -0,0 +1,10 @@
+export declare const asSecret: (s: any) => ISecret;
+export type ISecretVariant = 'generic' | 'password' | 'key' | 'token';
+export type ISecret = {
+    id: string;
+    variant: ISecretVariant;
+    name: string;
+    description: string;
+    value: string;
+};
+export default ISecret;

package/lib/models/Secret.js

@@ -0,0 +1,18 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2021-2024 Datalayer, Inc.
+ *
+ * Datalayer License
+ */
+export const asSecret = (s) => {
+    return {
+        id: s.uid,
+        variant: s.variant_s,
+        name: s.name_s,
+        description: s.description_t,
+        value: s.value_s,
+    };
+};

package/lib/models/Space.d.ts

@@ -0,0 +1,34 @@
+import { SpaceMember } from "./SpaceMember";
+import { ISpaceItem } from "./SpaceItem";
+import { ICourse as ICourse } from "./Course";
+import { IOrganization } from "./Organization";
+import { IUser } from "./User";
+/**
+ * Convert the raw space object to {@link ISpace}.
+ *
+ * @param user Raw space object from DB
+ * @returns Space
+ */
+export declare const asSpace: (raw_space: any) => ISpace;
+export type ISpaceVariant = 'default' | 'course';
+export type IAnySpace = ISpace | ICourse;
+export type IBaseSpace = {
+    id: string;
+    handle: string;
+    type: string;
+    variant: ISpaceVariant;
+    name: string;
+    description: string;
+    creationDate: Date;
+    public: boolean;
+    owner: IUser;
+    organization?: Partial<IOrganization>;
+    members?: SpaceMember[];
+};
+export type ISpace = IBaseSpace & {
+    type: 'space';
+    variant: 'default';
+    items?: Array<ISpaceItem>;
+    itemIds?: Array<string>;
+};
+export default ISpace;

package/lib/models/Space.js

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { asUser } from "./User";
+import { asArray } from "../utils";
+import { newUserMock } from './../mocks/models';
+/**
+ * Convert the raw space object to {@link ISpace}.
+ *
+ * @param user Raw space object from DB
+ * @returns Space
+ */
+export const asSpace = (raw_space) => {
+    const owner = newUserMock();
+    let members = new Array();
+    if (raw_space.members) {
+        members = asArray(raw_space.members).map(m => {
+            const member = asUser(m);
+            return member;
+        });
+    }
+    const space = {
+        id: raw_space.uid,
+        handle: raw_space.handle_s,
+        type: 'space',
+        variant: raw_space.variant_s,
+        name: raw_space.name_t,
+        description: raw_space.description_t,
+        public: raw_space.public_b,
+        members,
+        creationDate: new Date(raw_space.creation_ts_dt),
+        owner,
+        organization: {
+            handle: raw_space.handle_s,
+        }
+    };
+    return space;
+};

package/lib/models/SpaceItem.d.ts

@@ -0,0 +1,10 @@
+import { INotebook } from "./Notebook";
+import { IDocument } from "./Document";
+import { ICell } from "./Cell";
+import { IDataset } from "./Dataset";
+import { IEnvironment } from "./Environment";
+import { ILesson } from "./Lesson";
+import { IExercise } from "./Exercise";
+import { IAssignment } from "./Assignment";
+export type ISpaceItem = IDataset | INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
+export default ISpaceItem;

package/lib/models/SpaceItem.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/SpaceMember.d.ts

@@ -0,0 +1,6 @@
+import { Member } from "./Member";
+import { ISpace } from "./Space";
+export type SpaceMember = Member & {
+    space?: ISpace;
+};
+export default SpaceMember;

package/lib/models/SpaceMember.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/Student.d.ts

@@ -0,0 +1,6 @@
+import { IUser } from "./User";
+import { IStudentItem } from "./StudentItem";
+export type IStudent = IUser & {
+    studentItems?: Map<string, IStudentItem>;
+};
+export default IStudent;

package/lib/models/Student.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/StudentItem.d.ts

@@ -0,0 +1,21 @@
+import { IItemType } from "./ItemType";
+import { IStudent } from "./Student";
+import { ISpaceItem } from "./SpaceItem";
+export type IStudentItem = {
+    id: string;
+    type: 'student_item';
+    student?: IStudent;
+    item?: ISpaceItem;
+    itemId: string;
+    itemType: IItemType;
+    points?: number;
+    nbgrades?: any;
+    nbgradesTotalPoints?: number;
+    nbgradesTotalScore?: number;
+    completed?: boolean;
+    codeStudent?: string;
+    pass?: boolean;
+    invalid?: boolean;
+    invalidReason?: string;
+};
+export default IStudentItem;

package/lib/models/StudentItem.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/Survey.d.ts

@@ -0,0 +1,20 @@
+export declare const asSurvey: (s: any) => ISurvey;
+export type ICreateSurveyResponseType = {
+    success: boolean;
+    message: string;
+    survey: ISurvey;
+};
+export type IGetSurveysResponseType = {
+    success: boolean;
+    message: string;
+    surveys: Array<ISurvey>;
+};
+export type ISurvey = {
+    id: string;
+    name: string;
+    userId: string;
+    form: any;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export default ISurvey;

package/lib/models/Survey.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2021-2024 Datalayer, Inc.
+ *
+ * Datalayer License
+ */
+export const asSurvey = (s) => {
+    return {
+        id: s.uid,
+        name: s.name_s,
+        userId: s.user_id,
+        form: s.form,
+        createdAt: new Date(s.creation_ts_dt),
+        updatedAt: new Date(s.last_update_ts_dt),
+    };
+};

package/lib/models/Team.d.ts

@@ -0,0 +1,22 @@
+import { TeamMember } from "./TeamMember";
+import IOrganization from "./Organization";
+export type IAnyTeam = ITeam;
+export declare function asTeam(t: any, organizationId: string): ITeam;
+export type IBaseTeam = {
+    id: string;
+    type: string;
+    handle: string;
+    name: string;
+    description: string;
+    public: boolean;
+    creationDate: Date;
+    lastUpdateDate?: Date;
+    lastPublicationDate?: Date;
+    setMembers: (members: TeamMember[]) => void;
+};
+export type ITeam = IBaseTeam & {
+    type: 'team';
+    organization: Pick<IOrganization, "id">;
+    members: TeamMember[];
+};
+export default ITeam;