FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
JavaScriptSolidServer/src/wac/parser.js at patchAppend · bourgeoa/JavaScriptSolidServer · GitHub
bourgeoa
JavaScriptSolidServer
Repository navigation
Code
Issues
Pull requests
Actions
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
JavaScriptSolidServer
/
src
/
wac
/
parser.js
Copy path
More file actions
More file actions
Latest commit
History
History
History
403 lines (364 loc) · 10.6 KB
Breadcrumbs
JavaScriptSolidServer
/
src
/
wac
/
parser.js
Copy path
File metadata and controls
403 lines (364 loc) · 10.6 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
/**
* WAC (Web Access Control) Parser
* Parses ACL files (JSON-LD or Turtle) into authorization rules
*/
import
{
turtleToJsonLd
}
from
'../rdf/turtle.js'
;
import
{
safeJsonParse
}
from
'../utils/url.js'
;
const
ACL
=
'http://www.w3.org/ns/auth/acl#'
;
const
FOAF
=
'http://xmlns.com/foaf/0.1/'
;
// Access modes
export
const
AccessMode
=
{
READ
:
`
${
ACL
}
Read`
,
WRITE
:
`
${
ACL
}
Write`
,
APPEND
:
`
${
ACL
}
Append`
,
CONTROL
:
`
${
ACL
}
Control`
}
;
// Agent classes
export
const
AgentClass
=
{
AGENT
:
`
${
FOAF
}
Agent`
,
// Everyone (public)
AUTHENTICATED
:
`
${
ACL
}
AuthenticatedAgent`
// Any authenticated user
}
;
/**
* Parse an ACL document (JSON-LD or Turtle)
*
@param
{
string|object
} content - ACL content (JSON-LD string/object or Turtle string)
*
@param
{
string
} aclUrl - URL of the ACL document
*
@returns
{
Promise<Array<Authorization>>
} List of authorization rules
*/
export
async
function
parseAcl
(
content
,
aclUrl
)
{
let
doc
;
// If already an object, use it directly
if
(
typeof
content
===
'object'
&&
content
!==
null
)
{
doc
=
content
;
}
else
if
(
typeof
content
===
'string'
)
{
// Try JSON-LD first (with size limit for DoS protection)
try
{
doc
=
safeJsonParse
(
content
)
;
}
catch
{
// Not JSON, try Turtle
try
{
doc
=
await
turtleToJsonLd
(
content
,
aclUrl
)
;
}
catch
(
turtleError
)
{
// Neither JSON-LD nor valid Turtle
return
[
]
;
}
}
}
else
{
return
[
]
;
}
const
authorizations
=
[
]
;
// Handle @graph array or single object
const
nodes
=
Array
.
isArray
(
doc
)
?
doc
:
(
doc
[
'@graph'
]
||
[
doc
]
)
;
for
(
const
node
of
nodes
)
{
if
(
isAuthorization
(
node
)
)
{
const
auth
=
parseAuthorization
(
node
,
aclUrl
)
;
if
(
auth
)
{
authorizations
.
push
(
auth
)
;
}
}
}
return
authorizations
;
}
/**
* Check if node is an Authorization
*/
function
isAuthorization
(
node
)
{
const
type
=
node
[
'@type'
]
;
if
(
!
type
)
return
false
;
const
types
=
Array
.
isArray
(
type
)
?
type
:
[
type
]
;
return
types
.
some
(
t
=>
t
===
'acl:Authorization'
||
t
===
`
${
ACL
}
Authorization`
||
t
===
'Authorization'
)
;
}
/**
* Get base URL from ACL URL (the container the ACL applies to)
* e.g., https://example.com/foo/.acl -> https://example.com/foo/
* https://example.com/foo/bar.acl -> https://example.com/foo/
*/
function
getBaseUrl
(
aclUrl
)
{
if
(
!
aclUrl
)
return
null
;
// Remove .acl suffix and get the directory
const
withoutAcl
=
aclUrl
.
replace
(
/
\.
a
c
l
$
/
,
''
)
;
// If it was a container ACL (ended with /.acl), withoutAcl ends with /
// If it was a resource ACL (foo.acl), we need the parent directory
if
(
withoutAcl
.
endsWith
(
'/'
)
)
{
return
withoutAcl
;
}
// Get parent directory
const
lastSlash
=
withoutAcl
.
lastIndexOf
(
'/'
)
;
return
lastSlash
>
0
?
withoutAcl
.
substring
(
0
,
lastSlash
+
1
)
:
withoutAcl
;
}
/**
* Resolve a URI against a base URL
*/
function
resolveUri
(
uri
,
baseUrl
)
{
if
(
!
uri
||
!
baseUrl
)
return
uri
;
// Already absolute
if
(
uri
.
startsWith
(
'http://'
)
||
uri
.
startsWith
(
'https://'
)
)
return
uri
;
// Fragment-only (like #owner) - not a resource URL
if
(
uri
.
startsWith
(
'#'
)
)
return
uri
;
// Resolve relative URL
try
{
return
new
URL
(
uri
,
baseUrl
)
.
href
;
}
catch
{
return
uri
;
}
}
/**
* Parse a single Authorization node
*/
function
parseAuthorization
(
node
,
aclUrl
)
{
const
baseUrl
=
getBaseUrl
(
aclUrl
)
;
const
auth
=
{
id
:
node
[
'@id'
]
,
accessTo
:
[
]
,
// Resources this applies to
default
:
[
]
,
// Default for contained resources
agents
:
[
]
,
// Specific WebIDs
agentClasses
:
[
]
,
// Agent classes (public, authenticated)
agentGroups
:
[
]
,
// Groups
modes
:
[
]
,
// Access modes
conditions
:
[
]
// Access conditions (e.g. PaymentCondition)
}
;
// Parse accessTo - resolve relative URLs
auth
.
accessTo
=
parseUriArray
(
node
[
'acl:accessTo'
]
||
node
[
'accessTo'
]
)
.
map
(
uri
=>
resolveUri
(
uri
,
baseUrl
)
)
;
// Parse default (for containers) - resolve relative URLs
auth
.
default
=
parseUriArray
(
node
[
'acl:default'
]
||
node
[
'default'
]
)
.
map
(
uri
=>
resolveUri
(
uri
,
baseUrl
)
)
;
// Parse agents (WebIDs can be relative too) - resolve against ACL URL
auth
.
agents
=
parseUriArray
(
node
[
'acl:agent'
]
||
node
[
'agent'
]
)
.
map
(
uri
=>
resolveUri
(
uri
,
aclUrl
)
)
;
// Parse agentClass
auth
.
agentClasses
=
parseUriArray
(
node
[
'acl:agentClass'
]
||
node
[
'agentClass'
]
)
;
// Parse agentGroup
auth
.
agentGroups
=
parseUriArray
(
node
[
'acl:agentGroup'
]
||
node
[
'agentGroup'
]
)
;
// Parse modes
auth
.
modes
=
parseUriArray
(
node
[
'acl:mode'
]
||
node
[
'mode'
]
)
.
map
(
normalizeMode
)
;
// Parse conditions
auth
.
conditions
=
parseConditions
(
node
[
'acl:condition'
]
||
node
[
'condition'
]
)
;
return
auth
;
}
/**
* Parse conditions from an authorization node
*/
function
parseConditions
(
value
)
{
if
(
!
value
)
return
[
]
;
const
values
=
Array
.
isArray
(
value
)
?
value
:
[
value
]
;
return
values
.
map
(
v
=>
{
if
(
typeof
v
!==
'object'
||
v
===
null
)
return
null
;
const
type
=
v
[
'@type'
]
||
v
.
type
;
if
(
!
type
)
return
null
;
return
{
...
v
,
type
}
;
}
)
.
filter
(
Boolean
)
;
}
/**
* Parse a value that could be a URI, @id object, or array of either
*/
function
parseUriArray
(
value
)
{
if
(
!
value
)
return
[
]
;
const
values
=
Array
.
isArray
(
value
)
?
value
:
[
value
]
;
return
values
.
map
(
v
=>
{
if
(
typeof
v
===
'string'
)
return
v
;
if
(
v
&&
typeof
v
===
'object'
&&
v
[
'@id'
]
)
return
v
[
'@id'
]
;
return
null
;
}
)
.
filter
(
Boolean
)
;
}
/**
* Normalize mode URIs to full form
*/
function
normalizeMode
(
mode
)
{
const
modeMap
=
{
'Read'
:
AccessMode
.
READ
,
'Write'
:
AccessMode
.
WRITE
,
'Append'
:
AccessMode
.
APPEND
,
'Control'
:
AccessMode
.
CONTROL
,
'acl:Read'
:
AccessMode
.
READ
,
'acl:Write'
:
AccessMode
.
WRITE
,
'acl:Append'
:
AccessMode
.
APPEND
,
'acl:Control'
:
AccessMode
.
CONTROL
}
;
return
modeMap
[
mode
]
||
mode
;
}
/**
* Generate a default public read ACL
*
@param
{
string
} resourceUrl - URL of the resource
*
@returns
{
object
} JSON-LD ACL document
*/
export
function
generatePublicReadAcl
(
resourceUrl
)
{
return
{
'@context'
:
{
'acl'
:
ACL
,
'foaf'
:
FOAF
}
,
'@graph'
:
[
{
'@id'
:
'#public'
,
'@type'
:
'acl:Authorization'
,
'acl:agentClass'
:
{
'@id'
:
'foaf:Agent'
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
]
}
]
}
;
}
/**
* Generate a full owner ACL (owner has full control, public read)
*
@param
{
string
} resourceUrl - URL of the resource
*
@param
{
string
} ownerWebId - WebID of the owner
*
@param
{
boolean
} isContainer - Whether this is a container
*
@returns
{
object
} JSON-LD ACL document
*/
export
function
generateOwnerAcl
(
resourceUrl
,
ownerWebId
,
isContainer
=
false
)
{
const
graph
=
[
{
'@id'
:
'#owner'
,
'@type'
:
'acl:Authorization'
,
'acl:agent'
:
{
'@id'
:
ownerWebId
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
,
{
'@id'
:
'acl:Write'
}
,
{
'@id'
:
'acl:Control'
}
]
}
,
{
'@id'
:
'#public'
,
'@type'
:
'acl:Authorization'
,
'acl:agentClass'
:
{
'@id'
:
'foaf:Agent'
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
]
}
]
;
// Add default rules for containers
// Only owner gets default - children don't inherit public read
if
(
isContainer
)
{
graph
[
0
]
[
'acl:default'
]
=
{
'@id'
:
resourceUrl
}
;
// Note: intentionally not adding default to #public
// so child resources require authentication by default
}
return
{
'@context'
:
{
'acl'
:
ACL
,
'foaf'
:
FOAF
}
,
'@graph'
:
graph
}
;
}
/**
* Generate a private ACL (owner only, no public access)
*
@param
{
string
} resourceUrl - URL of the resource
*
@param
{
string
} ownerWebId - WebID of the owner
*
@param
{
boolean
} isContainer - Whether this is a container
*
@returns
{
object
} JSON-LD ACL document
*/
export
function
generatePrivateAcl
(
resourceUrl
,
ownerWebId
,
isContainer
=
true
)
{
const
auth
=
{
'@id'
:
'#owner'
,
'@type'
:
'acl:Authorization'
,
'acl:agent'
:
{
'@id'
:
ownerWebId
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
,
{
'@id'
:
'acl:Write'
}
,
{
'@id'
:
'acl:Control'
}
]
}
;
if
(
isContainer
)
{
auth
[
'acl:default'
]
=
{
'@id'
:
resourceUrl
}
;
}
return
{
'@context'
:
{
'acl'
:
ACL
,
'foaf'
:
FOAF
}
,
'@graph'
:
[
auth
]
}
;
}
/**
* Generate an inbox ACL (owner full control, public append)
*
@param
{
string
} resourceUrl - URL of the inbox
*
@param
{
string
} ownerWebId - WebID of the owner
*
@returns
{
object
} JSON-LD ACL document
*/
export
function
generateInboxAcl
(
resourceUrl
,
ownerWebId
)
{
return
{
'@context'
:
{
'acl'
:
ACL
,
'foaf'
:
FOAF
}
,
'@graph'
:
[
{
'@id'
:
'#owner'
,
'@type'
:
'acl:Authorization'
,
'acl:agent'
:
{
'@id'
:
ownerWebId
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:default'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
,
{
'@id'
:
'acl:Write'
}
,
{
'@id'
:
'acl:Control'
}
]
}
,
{
'@id'
:
'#public'
,
'@type'
:
'acl:Authorization'
,
'acl:agentClass'
:
{
'@id'
:
'foaf:Agent'
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:default'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Append'
}
]
}
]
}
;
}
/**
* Generate a public folder ACL (owner full control, public read with inheritance)
* Used for /public/ folders where content should be publicly readable
*
@param
{
string
} resourceUrl - URL of the folder
*
@param
{
string
} ownerWebId - WebID of the owner
*
@returns
{
object
} JSON-LD ACL document
*/
export
function
generatePublicFolderAcl
(
resourceUrl
,
ownerWebId
)
{
return
{
'@context'
:
{
'acl'
:
ACL
,
'foaf'
:
FOAF
}
,
'@graph'
:
[
{
'@id'
:
'#owner'
,
'@type'
:
'acl:Authorization'
,
'acl:agent'
:
{
'@id'
:
ownerWebId
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:default'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
,
{
'@id'
:
'acl:Write'
}
,
{
'@id'
:
'acl:Control'
}
]
}
,
{
'@id'
:
'#public'
,
'@type'
:
'acl:Authorization'
,
'acl:agentClass'
:
{
'@id'
:
'foaf:Agent'
}
,
'acl:accessTo'
:
{
'@id'
:
resourceUrl
}
,
'acl:default'
:
{
'@id'
:
resourceUrl
}
,
'acl:mode'
:
[
{
'@id'
:
'acl:Read'
}
]
}
]
}
;
}
/**
* Serialize ACL to JSON string
*/
export
function
serializeAcl
(
acl
)
{
return
JSON
.
stringify
(
acl
,
null
,
2
)
;
}
Back
|
FazBrowse Home
|
New Git URL