@weft-framework/server 0.0.0-stage → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +4 -2
- package/dist/account.d.ts +124 -0
- package/dist/account.js +344 -0
- package/dist/action.d.ts +43 -0
- package/dist/action.js +135 -0
- package/dist/admin.d.ts +99 -0
- package/dist/admin.js +431 -0
- package/dist/api.d.ts +21 -0
- package/dist/api.js +72 -0
- package/dist/app.d.ts +202 -0
- package/dist/app.js +3692 -0
- package/dist/assets.d.ts +4 -0
- package/dist/assets.js +91 -0
- package/dist/auth.d.ts +150 -0
- package/dist/auth.js +215 -0
- package/dist/backup.d.ts +46 -0
- package/dist/backup.js +345 -0
- package/dist/build.d.ts +33 -0
- package/dist/build.js +274 -0
- package/dist/bun.d.ts +30 -0
- package/dist/bun.js +53 -0
- package/dist/calendar.d.ts +161 -0
- package/dist/calendar.js +690 -0
- package/dist/compiler.d.ts +13 -0
- package/dist/compiler.js +58 -0
- package/dist/compress.d.ts +6 -0
- package/dist/compress.js +78 -0
- package/dist/config.d.ts +26 -0
- package/dist/config.js +317 -0
- package/dist/context.d.ts +9 -0
- package/dist/context.js +1 -0
- package/dist/contract.d.ts +18 -0
- package/dist/contract.js +171 -0
- package/dist/datamap.d.ts +24 -0
- package/dist/datamap.js +365 -0
- package/dist/db-backup.d.ts +27 -0
- package/dist/db-backup.js +115 -0
- package/dist/dev-events.d.ts +14 -0
- package/dist/dev-events.js +135 -0
- package/dist/dev.d.ts +1 -0
- package/dist/dev.js +240 -0
- package/dist/devtools-client.d.ts +1 -0
- package/dist/devtools-client.js +362 -0
- package/dist/devtools.d.ts +87 -0
- package/dist/devtools.js +68 -0
- package/dist/edge.d.ts +3 -0
- package/dist/edge.js +7 -0
- package/dist/email-signin.d.ts +92 -0
- package/dist/email-signin.js +259 -0
- package/dist/env.d.ts +1 -0
- package/dist/env.js +15 -0
- package/dist/explain.d.ts +12 -0
- package/dist/explain.js +217 -0
- package/dist/files.d.ts +6 -0
- package/dist/files.js +170 -0
- package/dist/grants.d.ts +69 -0
- package/dist/grants.js +206 -0
- package/dist/image/bitmap.d.ts +11 -0
- package/dist/image/bitmap.js +172 -0
- package/dist/image/jpeg.d.ts +10 -0
- package/dist/image/jpeg.js +697 -0
- package/dist/image/png.d.ts +8 -0
- package/dist/image/png.js +282 -0
- package/dist/image/transform.d.ts +20 -0
- package/dist/image/transform.js +52 -0
- package/dist/image/worker.d.ts +1 -0
- package/dist/image/worker.js +11 -0
- package/dist/images.d.ts +39 -0
- package/dist/images.js +283 -0
- package/dist/index.d.ts +64 -0
- package/dist/index.js +31 -0
- package/dist/inspect-hub.d.ts +42 -0
- package/dist/inspect-hub.js +14 -0
- package/dist/inspector.d.ts +51 -0
- package/dist/inspector.js +193 -0
- package/dist/job-admin.d.ts +55 -0
- package/dist/job-admin.js +89 -0
- package/dist/jobs.d.ts +222 -0
- package/dist/jobs.js +789 -0
- package/dist/live.d.ts +72 -0
- package/dist/live.js +481 -0
- package/dist/load-config.d.ts +2 -0
- package/dist/load-config.js +41 -0
- package/dist/log.d.ts +20 -0
- package/dist/log.js +143 -0
- package/dist/mail.d.ts +189 -0
- package/dist/mail.js +999 -0
- package/dist/media.d.ts +129 -0
- package/dist/media.js +470 -0
- package/dist/meta.d.ts +54 -0
- package/dist/meta.js +146 -0
- package/dist/middleware.d.ts +20 -0
- package/dist/middleware.js +101 -0
- package/dist/migrate.d.ts +12 -0
- package/dist/migrate.js +88 -0
- package/dist/node.d.ts +26 -0
- package/dist/node.js +96 -0
- package/dist/notice.d.ts +21 -0
- package/dist/notice.js +48 -0
- package/dist/npm.d.ts +16 -0
- package/dist/npm.js +347 -0
- package/dist/oauth.d.ts +76 -0
- package/dist/oauth.js +408 -0
- package/dist/otel.d.ts +57 -0
- package/dist/otel.js +293 -0
- package/dist/passkey.d.ts +99 -0
- package/dist/passkey.js +572 -0
- package/dist/password.d.ts +8 -0
- package/dist/password.js +65 -0
- package/dist/pdf.d.ts +46 -0
- package/dist/pdf.js +332 -0
- package/dist/personal-data.d.ts +22 -0
- package/dist/personal-data.js +148 -0
- package/dist/pointers.d.ts +9 -0
- package/dist/pointers.js +148 -0
- package/dist/postcss.d.ts +3 -0
- package/dist/postcss.js +89 -0
- package/dist/presence.d.ts +27 -0
- package/dist/presence.js +161 -0
- package/dist/preview.d.ts +25 -0
- package/dist/preview.js +353 -0
- package/dist/production.d.ts +16 -0
- package/dist/production.js +119 -0
- package/dist/project.d.ts +23 -0
- package/dist/project.js +536 -0
- package/dist/regions.d.ts +47 -0
- package/dist/regions.js +511 -0
- package/dist/replay.d.ts +44 -0
- package/dist/replay.js +259 -0
- package/dist/router.d.ts +29 -0
- package/dist/router.js +146 -0
- package/dist/rules-diff.d.ts +18 -0
- package/dist/rules-diff.js +165 -0
- package/dist/rules-test.d.ts +17 -0
- package/dist/rules-test.js +108 -0
- package/dist/saml.d.ts +160 -0
- package/dist/saml.js +959 -0
- package/dist/seal.d.ts +35 -0
- package/dist/seal.js +107 -0
- package/dist/secret.d.ts +14 -0
- package/dist/secret.js +110 -0
- package/dist/security.d.ts +53 -0
- package/dist/security.js +250 -0
- package/dist/seed.d.ts +16 -0
- package/dist/seed.js +94 -0
- package/dist/seo.d.ts +42 -0
- package/dist/seo.js +175 -0
- package/dist/settings.d.ts +79 -0
- package/dist/settings.js +212 -0
- package/dist/shared.d.ts +15 -0
- package/dist/shared.js +283 -0
- package/dist/shell.d.ts +12 -0
- package/dist/shell.js +118 -0
- package/dist/storage.d.ts +13 -0
- package/dist/storage.js +55 -0
- package/dist/support.d.ts +83 -0
- package/dist/support.js +236 -0
- package/dist/sync.d.ts +35 -0
- package/dist/sync.js +167 -0
- package/dist/tailwind.d.ts +14 -0
- package/dist/tailwind.js +117 -0
- package/dist/two-factor.d.ts +103 -0
- package/dist/two-factor.js +435 -0
- package/dist/uploads.d.ts +185 -0
- package/dist/uploads.js +991 -0
- package/dist/webhooks.d.ts +169 -0
- package/dist/webhooks.js +758 -0
- package/dist/webpush.d.ts +97 -0
- package/dist/webpush.js +372 -0
- package/dist/wizard.d.ts +141 -0
- package/dist/wizard.js +410 -0
- package/dist/workflows.d.ts +134 -0
- package/dist/workflows.js +511 -0
- package/package.json +186 -4
package/dist/grants.d.ts
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { type Grant, type Model } from "@weft-framework/data";
|
|
2
|
+
import type { PageContext } from "./context.js";
|
|
3
|
+
export interface GrantRow {
|
|
4
|
+
id: string;
|
|
5
|
+
model: string;
|
|
6
|
+
key: string;
|
|
7
|
+
numeric: boolean;
|
|
8
|
+
rights: "read" | "write";
|
|
9
|
+
by: string;
|
|
10
|
+
label: string;
|
|
11
|
+
created: number;
|
|
12
|
+
expires: number;
|
|
13
|
+
revoked: number;
|
|
14
|
+
revokedBy: string;
|
|
15
|
+
}
|
|
16
|
+
export interface GrantInfo {
|
|
17
|
+
id: string;
|
|
18
|
+
model: string;
|
|
19
|
+
key: string | number;
|
|
20
|
+
rights: "read" | "write";
|
|
21
|
+
by: string;
|
|
22
|
+
label: string;
|
|
23
|
+
created: number;
|
|
24
|
+
expires: number;
|
|
25
|
+
live: boolean;
|
|
26
|
+
revoked: number | null;
|
|
27
|
+
revokedBy: string | null;
|
|
28
|
+
}
|
|
29
|
+
export interface GrantsConfig {
|
|
30
|
+
manage?: (user: string, grant: GrantInfo) => boolean;
|
|
31
|
+
maxTtlMs?: number;
|
|
32
|
+
perUser?: number;
|
|
33
|
+
name?: string;
|
|
34
|
+
now?: () => number;
|
|
35
|
+
}
|
|
36
|
+
export interface IssueOptions {
|
|
37
|
+
ttlMs?: number;
|
|
38
|
+
session?: boolean;
|
|
39
|
+
label?: string;
|
|
40
|
+
}
|
|
41
|
+
export type GrantErrorCode = "invalid" | "forbidden" | "limit";
|
|
42
|
+
export declare class GrantError extends Error {
|
|
43
|
+
readonly code: GrantErrorCode;
|
|
44
|
+
constructor(code: GrantErrorCode, message: string);
|
|
45
|
+
}
|
|
46
|
+
export declare class Grants {
|
|
47
|
+
#private;
|
|
48
|
+
readonly models: {
|
|
49
|
+
Grant: Model<GrantRow>;
|
|
50
|
+
};
|
|
51
|
+
constructor(cfg?: GrantsConfig);
|
|
52
|
+
issue<T>(ctx: PageContext, actor: unknown, model: Model<T>, key: string | number, rights: "read" | "write", opts?: IssueOptions): Promise<{
|
|
53
|
+
id: string;
|
|
54
|
+
token: string;
|
|
55
|
+
expires: number;
|
|
56
|
+
}>;
|
|
57
|
+
accept(ctx: PageContext, token: string | null | undefined, opts?: {
|
|
58
|
+
session?: boolean;
|
|
59
|
+
}): Promise<Grant | null>;
|
|
60
|
+
list(user: string, filter?: {
|
|
61
|
+
model?: string;
|
|
62
|
+
key?: string | number;
|
|
63
|
+
all?: boolean;
|
|
64
|
+
}): GrantInfo[];
|
|
65
|
+
revoke(user: string, id: string): boolean;
|
|
66
|
+
revokeAll(user: string, model: string, key: string | number): number;
|
|
67
|
+
purge(keepMs?: number): number;
|
|
68
|
+
}
|
|
69
|
+
export declare function defineGrants(cfg?: GrantsConfig): Grants;
|
package/dist/grants.js
ADDED
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
import { randomBytes } from "node:crypto";
|
|
2
|
+
import { defineModel } from "@weft-framework/data";
|
|
3
|
+
import { seal, unseal } from "./seal.js";
|
|
4
|
+
export class GrantError extends Error {
|
|
5
|
+
code;
|
|
6
|
+
constructor(code, message) {
|
|
7
|
+
super(message);
|
|
8
|
+
this.name = "GrantError";
|
|
9
|
+
this.code = code;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
const ANY = "*";
|
|
13
|
+
class Holder {
|
|
14
|
+
id;
|
|
15
|
+
grant;
|
|
16
|
+
constructor(id, grant) {
|
|
17
|
+
this.id = id;
|
|
18
|
+
this.grant = grant;
|
|
19
|
+
Object.freeze(this);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
const readable = (a, r) => a instanceof Holder && (a.grant === ANY || a.grant === r.id);
|
|
23
|
+
const writable = (a) => a instanceof Holder && a.grant === ANY;
|
|
24
|
+
const readWhere = {
|
|
25
|
+
or: [
|
|
26
|
+
{ cmp: "==", l: { actor: ["grant"] }, r: { value: ANY } },
|
|
27
|
+
{ cmp: "==", l: { field: ["id"] }, r: { actor: ["grant"] } },
|
|
28
|
+
],
|
|
29
|
+
};
|
|
30
|
+
const writeWhere = { cmp: "==", l: { actor: ["grant"] }, r: { value: ANY } };
|
|
31
|
+
const PURPOSE = "weft.grant.kept";
|
|
32
|
+
const DAY = 24 * 60 * 60 * 1000;
|
|
33
|
+
const GRANT_ID = /^[A-Za-z0-9_-]{22}$/;
|
|
34
|
+
const PREFIX_RE = /^[A-Z][A-Za-z0-9]{0,31}$/;
|
|
35
|
+
const CONTROL_RE = /[\u0000-\u001f\u007f\u2028\u2029]/;
|
|
36
|
+
const SYSTEM = new Holder("grants:system", ANY);
|
|
37
|
+
function userId(v, what) {
|
|
38
|
+
if (typeof v !== "string" || v === "" || v.length > 200 || CONTROL_RE.test(v)) {
|
|
39
|
+
throw new GrantError("invalid", `${what} is a non-empty id of at most 200 characters`);
|
|
40
|
+
}
|
|
41
|
+
return v;
|
|
42
|
+
}
|
|
43
|
+
function info(r, now) {
|
|
44
|
+
return {
|
|
45
|
+
id: r.id,
|
|
46
|
+
model: r.model,
|
|
47
|
+
key: r.numeric ? Number(r.key) : r.key,
|
|
48
|
+
rights: r.rights,
|
|
49
|
+
by: r.by,
|
|
50
|
+
label: r.label,
|
|
51
|
+
created: r.created,
|
|
52
|
+
expires: r.expires,
|
|
53
|
+
live: r.revoked === 0 && r.expires > now,
|
|
54
|
+
revoked: r.revoked === 0 ? null : r.revoked,
|
|
55
|
+
revokedBy: r.revoked === 0 ? null : r.revokedBy,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
export class Grants {
|
|
59
|
+
models;
|
|
60
|
+
#manage;
|
|
61
|
+
#maxTtl;
|
|
62
|
+
#perUser;
|
|
63
|
+
#now;
|
|
64
|
+
constructor(cfg = {}) {
|
|
65
|
+
if (cfg === null || typeof cfg !== "object")
|
|
66
|
+
throw new GrantError("invalid", "defineGrants: a configuration object");
|
|
67
|
+
if (cfg.manage !== undefined && typeof cfg.manage !== "function")
|
|
68
|
+
throw new GrantError("invalid", "manage is a function (user, grant)");
|
|
69
|
+
const maxTtl = cfg.maxTtlMs ?? 90 * DAY;
|
|
70
|
+
if (!Number.isFinite(maxTtl) || maxTtl <= 0)
|
|
71
|
+
throw new GrantError("invalid", "maxTtlMs is a positive number of milliseconds");
|
|
72
|
+
const perUser = cfg.perUser ?? 1000;
|
|
73
|
+
if (!Number.isInteger(perUser) || perUser < 1)
|
|
74
|
+
throw new GrantError("invalid", "perUser is a whole number of at least 1");
|
|
75
|
+
const name = cfg.name ?? "Grant";
|
|
76
|
+
if (!PREFIX_RE.test(name))
|
|
77
|
+
throw new GrantError("invalid", "name is a model name");
|
|
78
|
+
this.#manage = cfg.manage ?? null;
|
|
79
|
+
this.#maxTtl = maxTtl;
|
|
80
|
+
this.#perUser = perUser;
|
|
81
|
+
this.#now = cfg.now ?? Date.now;
|
|
82
|
+
this.models = {
|
|
83
|
+
Grant: defineModel(name, {
|
|
84
|
+
fields: {
|
|
85
|
+
id: "string",
|
|
86
|
+
model: "string",
|
|
87
|
+
key: "string",
|
|
88
|
+
numeric: "boolean",
|
|
89
|
+
rights: "string",
|
|
90
|
+
by: "string",
|
|
91
|
+
label: "string",
|
|
92
|
+
created: "number",
|
|
93
|
+
expires: "number",
|
|
94
|
+
revoked: "number",
|
|
95
|
+
revokedBy: "string",
|
|
96
|
+
},
|
|
97
|
+
read: readable,
|
|
98
|
+
write: writable,
|
|
99
|
+
readWhere,
|
|
100
|
+
writeWhere,
|
|
101
|
+
}),
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
#may(user, row) {
|
|
105
|
+
if (row.by === user)
|
|
106
|
+
return true;
|
|
107
|
+
if (this.#manage === null)
|
|
108
|
+
return false;
|
|
109
|
+
try {
|
|
110
|
+
return this.#manage(user, info(row, this.#now())) === true;
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return false;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
async issue(ctx, actor, model, key, rights, opts = {}) {
|
|
117
|
+
const by = userId(actor?.id, "the actor's id");
|
|
118
|
+
if (rights !== "read" && rights !== "write")
|
|
119
|
+
throw new GrantError("invalid", `rights are "read" or "write"`);
|
|
120
|
+
if (typeof key !== "string" && !(typeof key === "number" && Number.isFinite(key))) {
|
|
121
|
+
throw new GrantError("invalid", "the key is a string or a finite number");
|
|
122
|
+
}
|
|
123
|
+
if (typeof key === "string" && (key === "" || key.length > 200))
|
|
124
|
+
throw new GrantError("invalid", "the key is 1-200 characters");
|
|
125
|
+
const ttl = opts.ttlMs ?? DAY;
|
|
126
|
+
if (!Number.isFinite(ttl) || ttl <= 0 || ttl > this.#maxTtl) {
|
|
127
|
+
throw new GrantError("invalid", `ttlMs is a positive number of milliseconds, at most ${this.#maxTtl}`);
|
|
128
|
+
}
|
|
129
|
+
if (opts.label !== undefined && typeof opts.label !== "string")
|
|
130
|
+
throw new GrantError("invalid", "label is a string");
|
|
131
|
+
const label = (opts.label ?? "").trim();
|
|
132
|
+
if (label.length > 200 || CONTROL_RE.test(label))
|
|
133
|
+
throw new GrantError("invalid", "a label is one line of at most 200 characters");
|
|
134
|
+
const scoped = model.as(actor);
|
|
135
|
+
const row = scoped.get(key);
|
|
136
|
+
if (row === undefined || (rights === "write" && !scoped.writable(row))) {
|
|
137
|
+
throw new GrantError("forbidden", `the actor may not ${rights} that ${model.name}, so cannot grant it`);
|
|
138
|
+
}
|
|
139
|
+
const now = this.#now();
|
|
140
|
+
const live = this.models.Grant.as(SYSTEM).where((g) => g.by === by && g.revoked === 0 && g.expires > now).length;
|
|
141
|
+
if (live >= this.#perUser)
|
|
142
|
+
throw new GrantError("limit", `at most ${this.#perUser} live grants per person; revoke some first`);
|
|
143
|
+
const id = randomBytes(16).toString("base64url");
|
|
144
|
+
const expires = now + ttl;
|
|
145
|
+
const token = await seal(ctx, { g: id, m: model.name, k: key, r: rights }, { purpose: PURPOSE, ttlMs: ttl, session: opts.session });
|
|
146
|
+
this.models.Grant.as(new Holder(by, ANY)).create({
|
|
147
|
+
id,
|
|
148
|
+
model: model.name,
|
|
149
|
+
key: String(key),
|
|
150
|
+
numeric: typeof key === "number",
|
|
151
|
+
rights,
|
|
152
|
+
by,
|
|
153
|
+
label,
|
|
154
|
+
created: now,
|
|
155
|
+
expires,
|
|
156
|
+
revoked: 0,
|
|
157
|
+
revokedBy: "",
|
|
158
|
+
});
|
|
159
|
+
return { id, token, expires };
|
|
160
|
+
}
|
|
161
|
+
async accept(ctx, token, opts = {}) {
|
|
162
|
+
const v = (await unseal(ctx, token, { purpose: PURPOSE, session: opts.session }));
|
|
163
|
+
if (typeof v !== "object" || v === null || typeof v.g !== "string" || !GRANT_ID.test(v.g))
|
|
164
|
+
return null;
|
|
165
|
+
const row = this.models.Grant.as(new Holder(`grant:${v.g}`, v.g)).get(v.g);
|
|
166
|
+
if (!row || row.revoked !== 0 || !(row.expires > this.#now()))
|
|
167
|
+
return null;
|
|
168
|
+
const key = row.numeric ? Number(row.key) : row.key;
|
|
169
|
+
if (row.model !== v.m || key !== v.k || row.rights !== v.r)
|
|
170
|
+
return null;
|
|
171
|
+
return { model: row.model, key, rights: row.rights, expires: row.expires };
|
|
172
|
+
}
|
|
173
|
+
list(user, filter = {}) {
|
|
174
|
+
const who = userId(user, "the user");
|
|
175
|
+
const now = this.#now();
|
|
176
|
+
const key = filter.key === undefined ? undefined : String(filter.key);
|
|
177
|
+
return this.models.Grant.as(new Holder(who, ANY))
|
|
178
|
+
.where((g) => (filter.model === undefined || g.model === filter.model) && (key === undefined || g.key === key))
|
|
179
|
+
.filter((g) => (filter.all === true || (g.revoked === 0 && g.expires > now)) && this.#may(who, g))
|
|
180
|
+
.sort((a, b) => b.created - a.created || (a.id < b.id ? -1 : 1))
|
|
181
|
+
.map((g) => info(g, now));
|
|
182
|
+
}
|
|
183
|
+
revoke(user, id) {
|
|
184
|
+
const who = userId(user, "the user");
|
|
185
|
+
if (typeof id !== "string" || !GRANT_ID.test(id))
|
|
186
|
+
return false;
|
|
187
|
+
const as = this.models.Grant.as(new Holder(who, ANY));
|
|
188
|
+
const row = as.get(id);
|
|
189
|
+
const now = this.#now();
|
|
190
|
+
if (!row || row.revoked !== 0 || !(row.expires > now) || !this.#may(who, row))
|
|
191
|
+
return false;
|
|
192
|
+
return as.update((g) => g.id === id && g.revoked === 0, { revoked: now, revokedBy: who }) === 1;
|
|
193
|
+
}
|
|
194
|
+
revokeAll(user, model, key) {
|
|
195
|
+
return this.list(user, { model, key }).filter((g) => this.revoke(user, g.id)).length;
|
|
196
|
+
}
|
|
197
|
+
purge(keepMs = 30 * DAY) {
|
|
198
|
+
if (!Number.isFinite(keepMs) || keepMs < 0)
|
|
199
|
+
throw new GrantError("invalid", "keepMs is a number of milliseconds");
|
|
200
|
+
const before = this.#now() - keepMs;
|
|
201
|
+
return this.models.Grant.as(SYSTEM).delete((g) => (g.revoked !== 0 && g.revoked < before) || g.expires < before);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
export function defineGrants(cfg = {}) {
|
|
205
|
+
return new Grants(cfg);
|
|
206
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export declare class ImageError extends Error {
|
|
2
|
+
}
|
|
3
|
+
export interface Bitmap {
|
|
4
|
+
width: number;
|
|
5
|
+
height: number;
|
|
6
|
+
data: Uint8Array;
|
|
7
|
+
}
|
|
8
|
+
export declare function crop(img: Bitmap, x: number, y: number, w: number, h: number): Bitmap;
|
|
9
|
+
export declare function orient(img: Bitmap, orientation: number): Bitmap;
|
|
10
|
+
export declare function resize(img: Bitmap, w: number, h: number): Bitmap;
|
|
11
|
+
export declare function flatten(img: Bitmap, rgb?: [number, number, number]): Bitmap;
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
export class ImageError extends Error {
|
|
2
|
+
}
|
|
3
|
+
export function crop(img, x, y, w, h) {
|
|
4
|
+
x = Math.max(0, Math.min(img.width - 1, Math.floor(x)));
|
|
5
|
+
y = Math.max(0, Math.min(img.height - 1, Math.floor(y)));
|
|
6
|
+
w = Math.max(1, Math.min(img.width - x, Math.round(w)));
|
|
7
|
+
h = Math.max(1, Math.min(img.height - y, Math.round(h)));
|
|
8
|
+
const data = new Uint8Array(w * h * 4);
|
|
9
|
+
for (let row = 0; row < h; row++) {
|
|
10
|
+
const s = ((y + row) * img.width + x) * 4;
|
|
11
|
+
data.set(img.data.subarray(s, s + w * 4), row * w * 4);
|
|
12
|
+
}
|
|
13
|
+
return { width: w, height: h, data };
|
|
14
|
+
}
|
|
15
|
+
export function orient(img, orientation) {
|
|
16
|
+
if (orientation < 2 || orientation > 8)
|
|
17
|
+
return img;
|
|
18
|
+
const { width: W, height: H, data } = img;
|
|
19
|
+
const swap = orientation >= 5;
|
|
20
|
+
const w = swap ? H : W;
|
|
21
|
+
const h = swap ? W : H;
|
|
22
|
+
const out = new Uint8Array(w * h * 4);
|
|
23
|
+
for (let y = 0; y < H; y++) {
|
|
24
|
+
for (let x = 0; x < W; x++) {
|
|
25
|
+
let nx;
|
|
26
|
+
let ny;
|
|
27
|
+
switch (orientation) {
|
|
28
|
+
case 2:
|
|
29
|
+
nx = W - 1 - x;
|
|
30
|
+
ny = y;
|
|
31
|
+
break;
|
|
32
|
+
case 3:
|
|
33
|
+
nx = W - 1 - x;
|
|
34
|
+
ny = H - 1 - y;
|
|
35
|
+
break;
|
|
36
|
+
case 4:
|
|
37
|
+
nx = x;
|
|
38
|
+
ny = H - 1 - y;
|
|
39
|
+
break;
|
|
40
|
+
case 5:
|
|
41
|
+
nx = y;
|
|
42
|
+
ny = x;
|
|
43
|
+
break;
|
|
44
|
+
case 6:
|
|
45
|
+
nx = H - 1 - y;
|
|
46
|
+
ny = x;
|
|
47
|
+
break;
|
|
48
|
+
case 7:
|
|
49
|
+
nx = H - 1 - y;
|
|
50
|
+
ny = W - 1 - x;
|
|
51
|
+
break;
|
|
52
|
+
default:
|
|
53
|
+
nx = y;
|
|
54
|
+
ny = W - 1 - x;
|
|
55
|
+
break;
|
|
56
|
+
}
|
|
57
|
+
const s = (y * W + x) * 4;
|
|
58
|
+
const d = (ny * w + nx) * 4;
|
|
59
|
+
out[d] = data[s];
|
|
60
|
+
out[d + 1] = data[s + 1];
|
|
61
|
+
out[d + 2] = data[s + 2];
|
|
62
|
+
out[d + 3] = data[s + 3];
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return { width: w, height: h, data: out };
|
|
66
|
+
}
|
|
67
|
+
const lanczos = (x) => {
|
|
68
|
+
if (x === 0)
|
|
69
|
+
return 1;
|
|
70
|
+
if (x <= -3 || x >= 3)
|
|
71
|
+
return 0;
|
|
72
|
+
const px = Math.PI * x;
|
|
73
|
+
return (3 * Math.sin(px) * Math.sin(px / 3)) / (px * px);
|
|
74
|
+
};
|
|
75
|
+
function weights(src, dst) {
|
|
76
|
+
const scale = dst / src;
|
|
77
|
+
const support = 3 * Math.max(1, 1 / scale);
|
|
78
|
+
const taps = Math.ceil(support) * 2 + 1;
|
|
79
|
+
const start = new Int32Array(dst);
|
|
80
|
+
const count = new Int32Array(dst);
|
|
81
|
+
const w = new Float32Array(dst * taps);
|
|
82
|
+
for (let i = 0; i < dst; i++) {
|
|
83
|
+
const center = (i + 0.5) / scale - 0.5;
|
|
84
|
+
const lo = Math.max(0, Math.floor(center - support));
|
|
85
|
+
const hi = Math.min(src - 1, Math.ceil(center + support));
|
|
86
|
+
const f = Math.min(1, scale);
|
|
87
|
+
let sum = 0;
|
|
88
|
+
let n = 0;
|
|
89
|
+
for (let j = lo; j <= hi && n < taps; j++, n++) {
|
|
90
|
+
const v = lanczos((j - center) * f);
|
|
91
|
+
w[i * taps + n] = v;
|
|
92
|
+
sum += v;
|
|
93
|
+
}
|
|
94
|
+
for (let k = 0; k < n; k++)
|
|
95
|
+
w[i * taps + k] /= sum || 1;
|
|
96
|
+
start[i] = lo;
|
|
97
|
+
count[i] = n;
|
|
98
|
+
}
|
|
99
|
+
return { start, count, w, taps };
|
|
100
|
+
}
|
|
101
|
+
export function resize(img, w, h) {
|
|
102
|
+
w = Math.max(1, Math.round(w));
|
|
103
|
+
h = Math.max(1, Math.round(h));
|
|
104
|
+
if (w === img.width && h === img.height)
|
|
105
|
+
return img;
|
|
106
|
+
const { width: W, height: H, data } = img;
|
|
107
|
+
const src = new Float32Array(W * H * 4);
|
|
108
|
+
for (let i = 0; i < W * H; i++) {
|
|
109
|
+
const a = data[i * 4 + 3] / 255;
|
|
110
|
+
src[i * 4] = data[i * 4] * a;
|
|
111
|
+
src[i * 4 + 1] = data[i * 4 + 1] * a;
|
|
112
|
+
src[i * 4 + 2] = data[i * 4 + 2] * a;
|
|
113
|
+
src[i * 4 + 3] = data[i * 4 + 3];
|
|
114
|
+
}
|
|
115
|
+
const hx = weights(W, w);
|
|
116
|
+
const mid = new Float32Array(w * H * 4);
|
|
117
|
+
for (let y = 0; y < H; y++) {
|
|
118
|
+
for (let x = 0; x < w; x++) {
|
|
119
|
+
let r = 0, g = 0, b = 0, a = 0;
|
|
120
|
+
const s0 = hx.start[x];
|
|
121
|
+
for (let k = 0; k < hx.count[x]; k++) {
|
|
122
|
+
const wt = hx.w[x * hx.taps + k];
|
|
123
|
+
const s = (y * W + s0 + k) * 4;
|
|
124
|
+
r += src[s] * wt;
|
|
125
|
+
g += src[s + 1] * wt;
|
|
126
|
+
b += src[s + 2] * wt;
|
|
127
|
+
a += src[s + 3] * wt;
|
|
128
|
+
}
|
|
129
|
+
const d = (y * w + x) * 4;
|
|
130
|
+
mid[d] = r;
|
|
131
|
+
mid[d + 1] = g;
|
|
132
|
+
mid[d + 2] = b;
|
|
133
|
+
mid[d + 3] = a;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
const vy = weights(H, h);
|
|
137
|
+
const out = new Uint8Array(w * h * 4);
|
|
138
|
+
const clamp = (v) => (v < 0 ? 0 : v > 255 ? 255 : Math.round(v));
|
|
139
|
+
for (let y = 0; y < h; y++) {
|
|
140
|
+
const s0 = vy.start[y];
|
|
141
|
+
for (let x = 0; x < w; x++) {
|
|
142
|
+
let r = 0, g = 0, b = 0, a = 0;
|
|
143
|
+
for (let k = 0; k < vy.count[y]; k++) {
|
|
144
|
+
const wt = vy.w[y * vy.taps + k];
|
|
145
|
+
const s = ((s0 + k) * w + x) * 4;
|
|
146
|
+
r += mid[s] * wt;
|
|
147
|
+
g += mid[s + 1] * wt;
|
|
148
|
+
b += mid[s + 2] * wt;
|
|
149
|
+
a += mid[s + 3] * wt;
|
|
150
|
+
}
|
|
151
|
+
const d = (y * w + x) * 4;
|
|
152
|
+
const alpha = clamp(a);
|
|
153
|
+
const k = alpha > 0 ? 255 / a : 0;
|
|
154
|
+
out[d] = alpha ? clamp(r * k) : 0;
|
|
155
|
+
out[d + 1] = alpha ? clamp(g * k) : 0;
|
|
156
|
+
out[d + 2] = alpha ? clamp(b * k) : 0;
|
|
157
|
+
out[d + 3] = alpha;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return { width: w, height: h, data: out };
|
|
161
|
+
}
|
|
162
|
+
export function flatten(img, rgb = [255, 255, 255]) {
|
|
163
|
+
const data = new Uint8Array(img.data.length);
|
|
164
|
+
for (let i = 0; i < data.length; i += 4) {
|
|
165
|
+
const a = img.data[i + 3] / 255;
|
|
166
|
+
data[i] = Math.round(img.data[i] * a + rgb[0] * (1 - a));
|
|
167
|
+
data[i + 1] = Math.round(img.data[i + 1] * a + rgb[1] * (1 - a));
|
|
168
|
+
data[i + 2] = Math.round(img.data[i + 2] * a + rgb[2] * (1 - a));
|
|
169
|
+
data[i + 3] = 255;
|
|
170
|
+
}
|
|
171
|
+
return { width: img.width, height: img.height, data };
|
|
172
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { type Bitmap } from "./bitmap.js";
|
|
2
|
+
export declare function isJpeg(b: Uint8Array): boolean;
|
|
3
|
+
export declare function jpegSize(b: Uint8Array): {
|
|
4
|
+
width: number;
|
|
5
|
+
height: number;
|
|
6
|
+
};
|
|
7
|
+
export declare function decodeJpeg(b: Uint8Array, maxPixels: number): Bitmap & {
|
|
8
|
+
orientation: number;
|
|
9
|
+
};
|
|
10
|
+
export declare function encodeJpeg(img: Bitmap, quality?: number): Uint8Array;
|