export const PLUGIN_GUID = 'asc.{7F4E8F35-5D66-47F8-A5B4-6AB3FAACF565}';
|
export const PLUGIN_VERSION = '0.1.0';
|
export const RECORD_FILL_SCOPE = 'onlyoffice:eln-record-fill';
|
export const RECORD_FILL_BIZ_MODULE = 'eln.record';
|
export const RECORD_FILL_BIZ_SCENE = 'eln.record.fill';
|
|
interface PluginContextBase {
|
apiBaseUrl: string;
|
bizDataId: string;
|
canFill: boolean;
|
documentId: string;
|
pluginVersion: typeof PLUGIN_VERSION;
|
ticket: string;
|
}
|
|
export type PluginContext = PluginContextBase & {
|
bizModule: typeof RECORD_FILL_BIZ_MODULE;
|
bizScene: typeof RECORD_FILL_BIZ_SCENE;
|
scope: typeof RECORD_FILL_SCOPE;
|
};
|
|
function isRecord(value: unknown): value is Record<string, unknown> {
|
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
}
|
|
function isNonEmptyString(value: unknown): value is string {
|
return typeof value === 'string' && value.trim().length > 0;
|
}
|
|
function isHttpUrl(value: unknown): value is string {
|
if (!isNonEmptyString(value)) return false;
|
try {
|
const parsed = new URL(value);
|
return ['http:', 'https:'].includes(parsed.protocol) && !parsed.username && !parsed.password && !parsed.search && !parsed.hash;
|
} catch {
|
return false;
|
}
|
}
|
|
export function parsePluginContext(options: unknown): PluginContext {
|
if (!isRecord(options)) throw new Error('插件运行上下文无效');
|
const isRecordFill = options.scope === RECORD_FILL_SCOPE && options.bizModule === RECORD_FILL_BIZ_MODULE && options.bizScene === RECORD_FILL_BIZ_SCENE;
|
if (
|
!isHttpUrl(options.apiBaseUrl) ||
|
!isNonEmptyString(options.ticket) ||
|
!isNonEmptyString(options.documentId) ||
|
!isNonEmptyString(options.bizDataId) ||
|
!isRecordFill ||
|
options.pluginVersion !== PLUGIN_VERSION ||
|
typeof options.canFill !== 'boolean'
|
) {
|
throw new Error('插件运行上下文无效');
|
}
|
return {
|
apiBaseUrl: options.apiBaseUrl.replace(/\/+$/u, ''),
|
ticket: options.ticket,
|
scope: options.scope,
|
documentId: options.documentId,
|
bizDataId: options.bizDataId,
|
bizModule: options.bizModule,
|
bizScene: options.bizScene,
|
pluginVersion: options.pluginVersion,
|
canFill: options.canFill,
|
} as PluginContext;
|
}
|
