@logto/schemas 1.15.0 → 1.17.0

package/alterations/1.16.0-1712912361-delete-jwt-customier-with-empty-script.ts

@@ -0,0 +1,23 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+const alteration: AlterationScript = {
+  // We are making the jwt-customizer script field mandatory
+  // Delete the records in logto_configs where key is jwt.accessToken or jwt.clientCredentials and value jsonb's script field is undefined
+  up: async (pool) => {
+    await pool.query(
+      sql`
+        delete from logto_configs 
+        where key in ('jwt.accessToken', 'jwt.clientCredentials')
+        and value->>'script' is null
+      `
+    );
+  },
+  down: async () => {
+    // No down script available, this is a non-reversible operation
+    // It is fine since we have not released this feature yet
+  },
+};
+
+export default alteration;

package/alterations/1.16.0-1713942039-add-organization-custom-data.ts

@@ -0,0 +1,25 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+/** The alteration script to add the `custom_data` field to the `organizations` table. */
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    await pool.query(
+      sql`
+        alter table organizations
+        add column custom_data jsonb not null default '{}'::jsonb;
+      `
+    );
+  },
+  down: async (pool) => {
+    await pool.query(
+      sql`
+        alter table organizations
+        drop column custom_data;
+      `
+    );
+  },
+};
+
+export default alteration;

package/alterations/1.16.0-1714270244-application-org-resource-scope.ts

@@ -0,0 +1,32 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+import { applyTableRls, dropTableRls } from './utils/1704934999-tables.js';
+
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    await pool.query(sql`
+      create table application_user_consent_organization_resource_scopes (
+        tenant_id varchar(21) not null
+          references tenants (id) on update cascade on delete cascade,
+        /** The globally unique identifier of the application. */
+        application_id varchar(21) not null
+          references applications (id) on update cascade on delete cascade,
+        /** The globally unique identifier of the resource scope. */
+        scope_id varchar(21) not null
+          references scopes (id) on update cascade on delete cascade,
+        primary key (application_id, scope_id)
+      );
+    `);
+    await applyTableRls(pool, 'application_user_consent_organization_resource_scopes');
+  },
+  down: async (pool) => {
+    await dropTableRls(pool, 'application_user_consent_organization_resource_scopes');
+    await pool.query(sql`
+      drop table application_user_consent_organization_resource_scopes
+    `);
+  },
+};
+
+export default alteration;

package/alterations/1.17.0-1715826336-add-default-user-role-config.ts

@@ -0,0 +1,18 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    await pool.query(sql`
+      alter table roles add column is_default boolean not null default false;
+    `);
+  },
+  down: async (pool) => {
+    await pool.query(sql`
+      alter table roles drop column is_default;
+    `);
+  },
+};
+
+export default alteration;

package/alterations/1.17.0-1715829731-rename-data-hook-schema-update-event.ts

@@ -0,0 +1,120 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+enum DataHookSchema {
+  User = 'User',
+  Role = 'Role',
+  Scope = 'Scope',
+  Organization = 'Organization',
+  OrganizationRole = 'OrganizationRole',
+  OrganizationScope = 'OrganizationScope',
+}
+
+type OldSchemaUpdateEvent = `${DataHookSchema}.${'Updated'}`;
+type NewSchemaUpdateEvent = `${DataHookSchema}.Data.Updated`;
+
+const oldSchemaUpdateEvents = Object.freeze([
+  'User.Updated',
+  'Role.Updated',
+  'Scope.Updated',
+  'Organization.Updated',
+  'OrganizationRole.Updated',
+  'OrganizationScope.Updated',
+] satisfies OldSchemaUpdateEvent[]);
+
+const newSchemaUpdateEvents = Object.freeze([
+  'User.Data.Updated',
+  'Role.Data.Updated',
+  'Scope.Data.Updated',
+  'Organization.Data.Updated',
+  'OrganizationRole.Data.Updated',
+  'OrganizationScope.Data.Updated',
+] as const satisfies NewSchemaUpdateEvent[]);
+
+const updateMap: { [key in OldSchemaUpdateEvent]: NewSchemaUpdateEvent } = {
+  'User.Updated': 'User.Data.Updated',
+  'Role.Updated': 'Role.Data.Updated',
+  'Scope.Updated': 'Scope.Data.Updated',
+  'Organization.Updated': 'Organization.Data.Updated',
+  'OrganizationRole.Updated': 'OrganizationRole.Data.Updated',
+  'OrganizationScope.Updated': 'OrganizationScope.Data.Updated',
+};
+
+const reverseMap: { [key in NewSchemaUpdateEvent]: OldSchemaUpdateEvent } = {
+  'User.Data.Updated': 'User.Updated',
+  'Role.Data.Updated': 'Role.Updated',
+  'Scope.Data.Updated': 'Scope.Updated',
+  'Organization.Data.Updated': 'Organization.Updated',
+  'OrganizationRole.Data.Updated': 'OrganizationRole.Updated',
+  'OrganizationScope.Data.Updated': 'OrganizationScope.Updated',
+};
+
+// This alteration script filters all the hook's events jsonb column to replace all the old schema update events with the new schema update events.
+
+const isOldSchemaUpdateEvent = (event: string): event is OldSchemaUpdateEvent =>
+  // eslint-disable-next-line no-restricted-syntax
+  oldSchemaUpdateEvents.includes(event as OldSchemaUpdateEvent);
+
+const isNewSchemaUpdateEvent = (event: string): event is NewSchemaUpdateEvent =>
+  // eslint-disable-next-line no-restricted-syntax
+  newSchemaUpdateEvents.includes(event as NewSchemaUpdateEvent);
+
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    const { rows: hooks } = await pool.query<{ id: string; events: string[] }>(sql`
+      select id, events
+      from hooks
+    `);
+
+    const hooksToBeUpdate = hooks.filter(({ events }) => {
+      return oldSchemaUpdateEvents.some((oldEvent) => events.includes(oldEvent));
+    });
+
+    await Promise.all(
+      hooksToBeUpdate.map(async ({ id, events }) => {
+        const updateEvents = events.reduce<string[]>((accumulator, event) => {
+          if (isOldSchemaUpdateEvent(event)) {
+            return [...accumulator, updateMap[event]];
+          }
+          return [...accumulator, event];
+        }, []);
+
+        await pool.query(sql`
+          update hooks
+          set events = ${JSON.stringify(updateEvents)}
+          where id = ${id};
+        `);
+      })
+    );
+  },
+  down: async (pool) => {
+    const { rows: hooks } = await pool.query<{ id: string; events: string[] }>(sql`
+      select id, events
+      from hooks
+    `);
+
+    const hooksToBeUpdate = hooks.filter(({ events }) => {
+      return newSchemaUpdateEvents.some((newEvent) => events.includes(newEvent));
+    });
+
+    await Promise.all(
+      hooksToBeUpdate.map(async ({ id, events }) => {
+        const updateEvents = events.reduce<string[]>((accumulator, event) => {
+          if (isNewSchemaUpdateEvent(event)) {
+            return [...accumulator, reverseMap[event]];
+          }
+          return [...accumulator, event];
+        }, []);
+
+        await pool.query(sql`
+          update hooks
+          set events = ${JSON.stringify(updateEvents)}
+          where id = ${id};
+        `);
+      })
+    );
+  },
+};
+
+export default alteration;

package/alterations/1.17.0-1716278409-remove-internal-role-database-policies.ts

@@ -0,0 +1,37 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    await pool.query(sql`
+      drop policy if exists roles_select on roles;
+      drop policy if exists roles_modification on roles;
+      create policy roles_modification on roles using (true);
+      
+      drop policy if exists roles_scopes_select on roles_scopes;
+      drop policy if exists roles_scopes_modification on roles_scopes;
+      create policy roles_scopes_modification on roles_scopes using (true);
+    `);
+  },
+  down: async (pool) => {
+    await pool.query(sql`
+      create policy roles_select on roles
+        for select using (true);
+
+      drop policy roles_modification on roles;
+      create policy roles_modification on roles
+        using (not starts_with(name, '#internal:'));
+
+      -- Restrict role - scope modification
+      create policy roles_scopes_select on roles_scopes
+        for select using (true);
+
+      drop policy roles_scopes_modification on roles_scopes;
+      create policy roles_scopes_modification on roles_scopes
+        using (not starts_with((select roles.name from roles where roles.id = role_id), '#internal:'));
+    `);
+  },
+};
+
+export default alteration;

package/alterations/1.17.0-1716291265-create-pre-configured-m-api-role.ts

@@ -0,0 +1,92 @@
+import { yes } from '@silverhand/essentials';
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+import { generateStandardId } from './utils/1716643968-id-generation.js';
+
+const isCi = yes(process.env.CI);
+
+const defaultTenantId = 'default';
+const defaultTenantManagementApiIndicator = `https://${defaultTenantId}.logto.app/api`;
+const roleName = 'Logto Management API access';
+const roleDescription = 'This default role grants access to the Logto management API.';
+enum RoleType {
+  MachineToMachine = 'MachineToMachine',
+}
+
+enum PredefinedScope {
+  All = 'all',
+}
+
+/**
+ * This script is to create a pre-configured Management API M2M role for new users.
+ * This script is **only for CI**, since we won't create this role for existing users, so this script is not applicable for existing db data.
+ */
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    if (!isCi) {
+      console.info(
+        "Skipping the alteration script `next-1716291265-create-pre-configured-m-api-role.ts` since it's should not be applied to existing db data."
+      );
+      return;
+    }
+
+    /**
+     * Only affect the `default` tenant, since this is the only tenant in the OSS version and the initial tenant in the cloud version.
+     * So we only need to care about this role for the `default` tenant.
+     */
+
+    const roleId = generateStandardId();
+
+    await pool.query(sql`
+      insert into roles (id, tenant_id, name, description, type)
+      values (
+        ${roleId},
+        ${defaultTenantId},
+        ${roleName},
+        ${roleDescription},
+        ${RoleType.MachineToMachine}
+      );
+    `);
+
+    // Assign Logto Management API permission `all` to the Logto Management API M2M role
+    await pool.query(sql`
+      insert into roles_scopes (id, role_id, scope_id, tenant_id)
+      values (
+        ${generateStandardId()},
+        ${roleId},
+        (
+          select scopes.id
+          from scopes
+          join resources on
+            scopes.tenant_id = resources.tenant_id and
+            scopes.resource_id = resources.id
+          where resources.indicator = ${defaultTenantManagementApiIndicator}
+          and scopes.name = ${PredefinedScope.All}
+          and scopes.tenant_id = ${defaultTenantId}
+        ),
+        ${defaultTenantId}
+      )
+    `);
+  },
+  down: async (pool) => {
+    if (!isCi) {
+      console.info(
+        "Skipping the down script `next-1716291265-create-pre-configured-m-api-role.ts` since it's should not be applied to production db."
+      );
+      return;
+    }
+
+    // Delete the created role
+    await pool.query(sql`
+      delete from roles
+      where tenant_id = ${defaultTenantId}
+      and name = ${roleName}
+      and description = ${roleDescription}
+      and type = ${RoleType.MachineToMachine}
+    `);
+  },
+};
+
+export default alteration;

package/alterations/1.17.0-1717148078-remove-service-log-reference.ts

@@ -0,0 +1,19 @@
+import { sql } from '@silverhand/slonik';
+
+import type { AlterationScript } from '../lib/types/alteration.js';
+
+const alteration: AlterationScript = {
+  up: async (pool) => {
+    await pool.query(sql`
+      alter table service_logs drop constraint service_logs_tenant_id_fkey;
+    `);
+  },
+  down: async (pool) => {
+    await pool.query(sql`
+      alter table service_logs add constraint service_logs_tenant_id_fkey 
+        foreign key (tenant_id) references tenants(id) on update cascade on delete cascade;
+    `);
+  },
+};
+
+export default alteration;

package/alterations/utils/1716643968-id-generation.ts

@@ -0,0 +1,46 @@
+/**
+ * This file is forked from `@logto/shared` 3.1.0 to avoid alteration scripts to depend on outer packages.
+ */
+import { customAlphabet } from 'nanoid';
+
+const lowercaseAlphabet = '0123456789abcdefghijklmnopqrstuvwxyz';
+const alphabet = `${lowercaseAlphabet}ABCDEFGHIJKLMNOPQRSTUVWXYZ` as const;
+
+type BuildIdGenerator = {
+  /**
+   * Build a nanoid generator function uses numbers (0-9), lowercase letters (a-z), and uppercase letters (A-Z) as the alphabet.
+   * @param size The default id length for the generator.
+   */
+  (size: number): ReturnType<typeof customAlphabet>;
+  /**
+   * Build a nanoid generator function uses numbers (0-9) and lowercase letters (a-z) as the alphabet.
+   * @param size The default id length for the generator.
+   */
+  // eslint-disable-next-line @typescript-eslint/unified-signatures
+  (size: number, includingUppercase: false): ReturnType<typeof customAlphabet>;
+};
+
+const buildIdGenerator: BuildIdGenerator = (size: number, includingUppercase = true) =>
+  customAlphabet(includingUppercase ? alphabet : lowercaseAlphabet, size);
+
+/**
+ * Generate a standard id with 21 characters, including lowercase letters and numbers.
+ *
+ * @see {@link lowercaseAlphabet}
+ */
+export const generateStandardId = buildIdGenerator(21, false);
+
+/**
+ * Generate a standard short id with 12 characters, including lowercase letters and numbers.
+ *
+ * @see {@link lowercaseAlphabet}
+ */
+export const generateStandardShortId = buildIdGenerator(12, false);
+
+/**
+ * Generate a standard secret with 32 characters, including uppercase letters, lowercase
+ * letters, and numbers.
+ *
+ * @see {@link alphabet}
+ */
+export const generateStandardSecret = buildIdGenerator(32);

package/alterations-js/1.16.0-1712912361-delete-jwt-customier-with-empty-script.d.ts

@@ -0,0 +1,3 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.16.0-1712912361-delete-jwt-customier-with-empty-script.js

@@ -0,0 +1,17 @@
+import { sql } from '@silverhand/slonik';
+const alteration = {
+    // We are making the jwt-customizer script field mandatory
+    // Delete the records in logto_configs where key is jwt.accessToken or jwt.clientCredentials and value jsonb's script field is undefined
+    up: async (pool) => {
+        await pool.query(sql `
+        delete from logto_configs 
+        where key in ('jwt.accessToken', 'jwt.clientCredentials')
+        and value->>'script' is null
+      `);
+    },
+    down: async () => {
+        // No down script available, this is a non-reversible operation
+        // It is fine since we have not released this feature yet
+    },
+};
+export default alteration;

package/alterations-js/1.16.0-1713942039-add-organization-custom-data.d.ts

@@ -0,0 +1,4 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+/** The alteration script to add the `custom_data` field to the `organizations` table. */
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.16.0-1713942039-add-organization-custom-data.js

@@ -0,0 +1,17 @@
+import { sql } from '@silverhand/slonik';
+/** The alteration script to add the `custom_data` field to the `organizations` table. */
+const alteration = {
+    up: async (pool) => {
+        await pool.query(sql `
+        alter table organizations
+        add column custom_data jsonb not null default '{}'::jsonb;
+      `);
+    },
+    down: async (pool) => {
+        await pool.query(sql `
+        alter table organizations
+        drop column custom_data;
+      `);
+    },
+};
+export default alteration;

package/alterations-js/1.16.0-1714270244-application-org-resource-scope.d.ts

@@ -0,0 +1,3 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.16.0-1714270244-application-org-resource-scope.js

@@ -0,0 +1,27 @@
+import { sql } from '@silverhand/slonik';
+import { applyTableRls, dropTableRls } from './utils/1704934999-tables.js';
+const alteration = {
+    up: async (pool) => {
+        await pool.query(sql `
+      create table application_user_consent_organization_resource_scopes (
+        tenant_id varchar(21) not null
+          references tenants (id) on update cascade on delete cascade,
+        /** The globally unique identifier of the application. */
+        application_id varchar(21) not null
+          references applications (id) on update cascade on delete cascade,
+        /** The globally unique identifier of the resource scope. */
+        scope_id varchar(21) not null
+          references scopes (id) on update cascade on delete cascade,
+        primary key (application_id, scope_id)
+      );
+    `);
+        await applyTableRls(pool, 'application_user_consent_organization_resource_scopes');
+    },
+    down: async (pool) => {
+        await dropTableRls(pool, 'application_user_consent_organization_resource_scopes');
+        await pool.query(sql `
+      drop table application_user_consent_organization_resource_scopes
+    `);
+    },
+};
+export default alteration;

package/alterations-js/1.17.0-1715826336-add-default-user-role-config.d.ts

@@ -0,0 +1,3 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.17.0-1715826336-add-default-user-role-config.js

@@ -0,0 +1,14 @@
+import { sql } from '@silverhand/slonik';
+const alteration = {
+    up: async (pool) => {
+        await pool.query(sql `
+      alter table roles add column is_default boolean not null default false;
+    `);
+    },
+    down: async (pool) => {
+        await pool.query(sql `
+      alter table roles drop column is_default;
+    `);
+    },
+};
+export default alteration;

package/alterations-js/1.17.0-1715829731-rename-data-hook-schema-update-event.d.ts

@@ -0,0 +1,3 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.17.0-1715829731-rename-data-hook-schema-update-event.js

@@ -0,0 +1,96 @@
+import { sql } from '@silverhand/slonik';
+var DataHookSchema;
+(function (DataHookSchema) {
+    DataHookSchema["User"] = "User";
+    DataHookSchema["Role"] = "Role";
+    DataHookSchema["Scope"] = "Scope";
+    DataHookSchema["Organization"] = "Organization";
+    DataHookSchema["OrganizationRole"] = "OrganizationRole";
+    DataHookSchema["OrganizationScope"] = "OrganizationScope";
+})(DataHookSchema || (DataHookSchema = {}));
+const oldSchemaUpdateEvents = Object.freeze([
+    'User.Updated',
+    'Role.Updated',
+    'Scope.Updated',
+    'Organization.Updated',
+    'OrganizationRole.Updated',
+    'OrganizationScope.Updated',
+]);
+const newSchemaUpdateEvents = Object.freeze([
+    'User.Data.Updated',
+    'Role.Data.Updated',
+    'Scope.Data.Updated',
+    'Organization.Data.Updated',
+    'OrganizationRole.Data.Updated',
+    'OrganizationScope.Data.Updated',
+]);
+const updateMap = {
+    'User.Updated': 'User.Data.Updated',
+    'Role.Updated': 'Role.Data.Updated',
+    'Scope.Updated': 'Scope.Data.Updated',
+    'Organization.Updated': 'Organization.Data.Updated',
+    'OrganizationRole.Updated': 'OrganizationRole.Data.Updated',
+    'OrganizationScope.Updated': 'OrganizationScope.Data.Updated',
+};
+const reverseMap = {
+    'User.Data.Updated': 'User.Updated',
+    'Role.Data.Updated': 'Role.Updated',
+    'Scope.Data.Updated': 'Scope.Updated',
+    'Organization.Data.Updated': 'Organization.Updated',
+    'OrganizationRole.Data.Updated': 'OrganizationRole.Updated',
+    'OrganizationScope.Data.Updated': 'OrganizationScope.Updated',
+};
+// This alteration script filters all the hook's events jsonb column to replace all the old schema update events with the new schema update events.
+const isOldSchemaUpdateEvent = (event) => 
+// eslint-disable-next-line no-restricted-syntax
+oldSchemaUpdateEvents.includes(event);
+const isNewSchemaUpdateEvent = (event) => 
+// eslint-disable-next-line no-restricted-syntax
+newSchemaUpdateEvents.includes(event);
+const alteration = {
+    up: async (pool) => {
+        const { rows: hooks } = await pool.query(sql `
+      select id, events
+      from hooks
+    `);
+        const hooksToBeUpdate = hooks.filter(({ events }) => {
+            return oldSchemaUpdateEvents.some((oldEvent) => events.includes(oldEvent));
+        });
+        await Promise.all(hooksToBeUpdate.map(async ({ id, events }) => {
+            const updateEvents = events.reduce((accumulator, event) => {
+                if (isOldSchemaUpdateEvent(event)) {
+                    return [...accumulator, updateMap[event]];
+                }
+                return [...accumulator, event];
+            }, []);
+            await pool.query(sql `
+          update hooks
+          set events = ${JSON.stringify(updateEvents)}
+          where id = ${id};
+        `);
+        }));
+    },
+    down: async (pool) => {
+        const { rows: hooks } = await pool.query(sql `
+      select id, events
+      from hooks
+    `);
+        const hooksToBeUpdate = hooks.filter(({ events }) => {
+            return newSchemaUpdateEvents.some((newEvent) => events.includes(newEvent));
+        });
+        await Promise.all(hooksToBeUpdate.map(async ({ id, events }) => {
+            const updateEvents = events.reduce((accumulator, event) => {
+                if (isNewSchemaUpdateEvent(event)) {
+                    return [...accumulator, reverseMap[event]];
+                }
+                return [...accumulator, event];
+            }, []);
+            await pool.query(sql `
+          update hooks
+          set events = ${JSON.stringify(updateEvents)}
+          where id = ${id};
+        `);
+        }));
+    },
+};
+export default alteration;

package/alterations-js/1.17.0-1716278409-remove-internal-role-database-policies.d.ts

@@ -0,0 +1,3 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+declare const alteration: AlterationScript;
+export default alteration;

package/alterations-js/1.17.0-1716278409-remove-internal-role-database-policies.js

@@ -0,0 +1,33 @@
+import { sql } from '@silverhand/slonik';
+const alteration = {
+    up: async (pool) => {
+        await pool.query(sql `
+      drop policy if exists roles_select on roles;
+      drop policy if exists roles_modification on roles;
+      create policy roles_modification on roles using (true);
+      
+      drop policy if exists roles_scopes_select on roles_scopes;
+      drop policy if exists roles_scopes_modification on roles_scopes;
+      create policy roles_scopes_modification on roles_scopes using (true);
+    `);
+    },
+    down: async (pool) => {
+        await pool.query(sql `
+      create policy roles_select on roles
+        for select using (true);
+
+      drop policy roles_modification on roles;
+      create policy roles_modification on roles
+        using (not starts_with(name, '#internal:'));
+
+      -- Restrict role - scope modification
+      create policy roles_scopes_select on roles_scopes
+        for select using (true);
+
+      drop policy roles_scopes_modification on roles_scopes;
+      create policy roles_scopes_modification on roles_scopes
+        using (not starts_with((select roles.name from roles where roles.id = role_id), '#internal:'));
+    `);
+    },
+};
+export default alteration;

package/alterations-js/1.17.0-1716291265-create-pre-configured-m-api-role.d.ts

@@ -0,0 +1,7 @@
+import type { AlterationScript } from '../lib/types/alteration.js';
+/**
+ * This script is to create a pre-configured Management API M2M role for new users.
+ * This script is **only for CI**, since we won't create this role for existing users, so this script is not applicable for existing db data.
+ */
+declare const alteration: AlterationScript;
+export default alteration;