Method init

src/node/db/Pad.ts:584–632

(text:string, authorId = '')

  }

  async init(text:string, authorId = '') {
    // try to load the pad
    const value = await this.db.get(`pad:${this.id}`) as Record<string, any> | null;

    // if this pad exists, load it
    if (value != null) {
      Object.assign(this, value);
      if ('pool' in value) this.pool = new AttributePool().fromJsonable(value.pool);
    } else {
      // Auto-generated default content (settings.defaultPadText or whatever a
      // padDefaultContent hook substitutes) is not written by the user who
      // happens to open the pad first, so the text must not carry their author
      // attribute — otherwise the welcome text shows up in the creator's
      // authorship colour (issue #7885). Track whether the text came from the
      // default-content path so its insert op can be attributed to the system
      // author.
      const usedDefaultContent = (text == null);
      if (usedDefaultContent) {
        const context = {pad: this, authorId, type: 'text', content: settings.defaultPadText};
        await hooks.aCallAll('padDefaultContent', context);
        if (context.type !== 'text') throw new Error(`unsupported content type: ${context.type}`);
        text = exports.cleanText(context.content);
      }
      // The author *attribute* applied to the initial text — i.e. what colours
      // it in the editor — is the stable system author when the content is
      // auto-generated default text (#7885), or when non-empty text was
      // supplied without an authorId (internal getPad calls during HTTP API
      // setup, plugin-driven pad creation). The latter keeps the insert op
      // carrying an `author` attribute, mirroring the substitution
      // setText/appendText already do via spliceText.
      const attribAuthorId =
          ((usedDefaultContent || !authorId) && text.length > 0)
            ? Pad.SYSTEM_AUTHOR_ID : authorId;
      const firstAttribs = attribAuthorId
          ? [['author', attribAuthorId] as [string, string]]
          : undefined;
      // The *revision* author (revs:0 meta.author) stays the real creator so
      // pad ownership is preserved: isPadCreator() / the pad-wide settings gate
      // and the deletion token all key off getRevisionAuthor(0). Only when no
      // author was supplied at all do we fall back to the system author, so the
      // initial revision still records a stable, non-empty author.
      const revisionAuthorId =
          authorId || (text.length > 0 ? Pad.SYSTEM_AUTHOR_ID : '');
      const firstChangeset = makeSplice('\n', 0, 0, text, firstAttribs, this.pool);
      await this.appendRevision(firstChangeset, revisionAuthorId);
    }
    this.padSettings = Pad.normalizePadSettings(this.padSettings);
    await hooks.aCallAll('padLoad', {pad: this});
  }

  async copy(destinationID: string, force: boolean) {
    // Kick everyone from this pad.