luau-obfuscator 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,79 @@
+import { Program } from 'luau-parser';
+
+interface StringsToExpressionsOptions {
+    /** 청크 하나에 들어가는 바이트 개수 최소값 */
+    min: number;
+    /** 청크 하나에 들어가는 바이트 개수 최대값 */
+    max: number;
+}
+
+interface NumbersToExpressionsOptions {
+    /** 랜덤 보조항의 최소 절댓값 */
+    min: number;
+    /** 랜덤 보조항의 최대 절댓값 */
+    max: number;
+}
+
+interface RenameVariablesOptions {
+    random?: () => string;
+}
+
+interface GlobalMappingOptions {
+    /** 전역들을 담아둘 최상단 local 테이블 변수 이름. RenameVariables가 이후에
+     *  다시 실행되면 이 이름도 다른 이름으로 한 번 더 바뀜. */
+    tableName: string;
+}
+
+interface EncryptStringsOptions {
+}
+
+interface EncryptNumbersOptions {
+}
+
+type ObfuscateConfigEach<C> = ({
+    active: true;
+} & C) | {
+    active: false;
+};
+type ObfuscateConfig = {
+    Vmify: ObfuscateConfigEach<{}>;
+    Minify: ObfuscateConfigEach<{}>;
+    StringsToExpressions: ObfuscateConfigEach<StringsToExpressionsOptions>;
+    NumbersToExpressions: ObfuscateConfigEach<NumbersToExpressionsOptions>;
+    EncryptStrings: ObfuscateConfigEach<EncryptStringsOptions>;
+    EncryptNumbers: ObfuscateConfigEach<EncryptNumbersOptions>;
+    RenameVariables: ObfuscateConfigEach<RenameVariablesOptions>;
+    GlobalMapping: ObfuscateConfigEach<GlobalMappingOptions>;
+    ConstantArray: ObfuscateConfigEach<{}>;
+    InsertJunk: ObfuscateConfigEach<{
+        probability: number;
+        maxPerBlock: number;
+    }>;
+    WrapInFunction: ObfuscateConfigEach<{}>;
+};
+type ExtractOptions<T> = T extends {
+    active: true;
+} ? Omit<T, "active"> : never;
+/**
+ * 사용자가 넘기는 partial config.
+ * 각 feature는 `{active:false}`를 통째로 넘기거나,
+ * `{active:true}` + 옵션 일부만 override 하는 형태만 허용.
+ * (재귀적 DeepMerge는 이 판별 유니온 구조를 깨서 쓰지 않음)
+ */
+type ObfuscatePartialConfig = {
+    [K in keyof ObfuscateConfig]?: {
+        active: false;
+    } | ({
+        active: true;
+    } & Partial<ExtractOptions<ObfuscateConfig[K]>>);
+};
+declare const ObfuscateDefault: ObfuscateConfig;
+
+type PassFn = (program: Program, options: any) => void;
+declare const PASS_ORDER: (keyof ObfuscateConfig)[];
+declare const PASS_MAP: Partial<Record<keyof ObfuscateConfig, PassFn>>;
+
+declare function obfuscateByAst(program: Program, PConfig?: ObfuscatePartialConfig): string;
+declare function obfuscate(source: string, PConfig?: ObfuscatePartialConfig): string;
+
+export { type ObfuscateConfig, type ObfuscateConfigEach, ObfuscateDefault, type ObfuscatePartialConfig, PASS_MAP, PASS_ORDER, obfuscate, obfuscateByAst };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { Program } from 'luau-parser';
+
+interface StringsToExpressionsOptions {
+    /** 청크 하나에 들어가는 바이트 개수 최소값 */
+    min: number;
+    /** 청크 하나에 들어가는 바이트 개수 최대값 */
+    max: number;
+}
+
+interface NumbersToExpressionsOptions {
+    /** 랜덤 보조항의 최소 절댓값 */
+    min: number;
+    /** 랜덤 보조항의 최대 절댓값 */
+    max: number;
+}
+
+interface RenameVariablesOptions {
+    random?: () => string;
+}
+
+interface GlobalMappingOptions {
+    /** 전역들을 담아둘 최상단 local 테이블 변수 이름. RenameVariables가 이후에
+     *  다시 실행되면 이 이름도 다른 이름으로 한 번 더 바뀜. */
+    tableName: string;
+}
+
+interface EncryptStringsOptions {
+}
+
+interface EncryptNumbersOptions {
+}
+
+type ObfuscateConfigEach<C> = ({
+    active: true;
+} & C) | {
+    active: false;
+};
+type ObfuscateConfig = {
+    Vmify: ObfuscateConfigEach<{}>;
+    Minify: ObfuscateConfigEach<{}>;
+    StringsToExpressions: ObfuscateConfigEach<StringsToExpressionsOptions>;
+    NumbersToExpressions: ObfuscateConfigEach<NumbersToExpressionsOptions>;
+    EncryptStrings: ObfuscateConfigEach<EncryptStringsOptions>;
+    EncryptNumbers: ObfuscateConfigEach<EncryptNumbersOptions>;
+    RenameVariables: ObfuscateConfigEach<RenameVariablesOptions>;
+    GlobalMapping: ObfuscateConfigEach<GlobalMappingOptions>;
+    ConstantArray: ObfuscateConfigEach<{}>;
+    InsertJunk: ObfuscateConfigEach<{
+        probability: number;
+        maxPerBlock: number;
+    }>;
+    WrapInFunction: ObfuscateConfigEach<{}>;
+};
+type ExtractOptions<T> = T extends {
+    active: true;
+} ? Omit<T, "active"> : never;
+/**
+ * 사용자가 넘기는 partial config.
+ * 각 feature는 `{active:false}`를 통째로 넘기거나,
+ * `{active:true}` + 옵션 일부만 override 하는 형태만 허용.
+ * (재귀적 DeepMerge는 이 판별 유니온 구조를 깨서 쓰지 않음)
+ */
+type ObfuscatePartialConfig = {
+    [K in keyof ObfuscateConfig]?: {
+        active: false;
+    } | ({
+        active: true;
+    } & Partial<ExtractOptions<ObfuscateConfig[K]>>);
+};
+declare const ObfuscateDefault: ObfuscateConfig;
+
+type PassFn = (program: Program, options: any) => void;
+declare const PASS_ORDER: (keyof ObfuscateConfig)[];
+declare const PASS_MAP: Partial<Record<keyof ObfuscateConfig, PassFn>>;
+
+declare function obfuscateByAst(program: Program, PConfig?: ObfuscatePartialConfig): string;
+declare function obfuscate(source: string, PConfig?: ObfuscatePartialConfig): string;
+
+export { type ObfuscateConfig, type ObfuscateConfigEach, ObfuscateDefault, type ObfuscatePartialConfig, PASS_MAP, PASS_ORDER, obfuscate, obfuscateByAst };