@decocms/blocks 8.1.0-next.1 → 8.1.0-next.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/bin/deco.js +5 -12
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/protocol/assets.d.ts +46 -0
- package/dist/protocol/assets.d.ts.map +1 -0
- package/dist/protocol/assets.js +105 -0
- package/dist/protocol/assets.js.map +1 -0
- package/dist/protocol/canonical.d.ts +8 -0
- package/dist/protocol/canonical.d.ts.map +1 -0
- package/dist/protocol/canonical.js +8 -0
- package/dist/protocol/canonical.js.map +1 -0
- package/dist/protocol/ciphertext.d.ts +7 -0
- package/dist/protocol/ciphertext.d.ts.map +1 -0
- package/dist/protocol/ciphertext.js +7 -0
- package/dist/protocol/ciphertext.js.map +1 -0
- package/dist/protocol/client.d.ts +54 -0
- package/dist/protocol/client.d.ts.map +1 -0
- package/dist/protocol/client.js +104 -0
- package/dist/protocol/client.js.map +1 -0
- package/dist/protocol/conformance/cases/assets.d.ts +3 -0
- package/dist/protocol/conformance/cases/assets.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/assets.js +71 -0
- package/dist/protocol/conformance/cases/assets.js.map +1 -0
- package/dist/protocol/conformance/cases/guards.d.ts +3 -0
- package/dist/protocol/conformance/cases/guards.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/guards.js +265 -0
- package/dist/protocol/conformance/cases/guards.js.map +1 -0
- package/dist/protocol/conformance/cases/reads.d.ts +3 -0
- package/dist/protocol/conformance/cases/reads.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/reads.js +140 -0
- package/dist/protocol/conformance/cases/reads.js.map +1 -0
- package/dist/protocol/conformance/cases/types.d.ts +9 -0
- package/dist/protocol/conformance/cases/types.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/types.js +2 -0
- package/dist/protocol/conformance/cases/types.js.map +1 -0
- package/dist/protocol/conformance/cases/wire.d.ts +3 -0
- package/dist/protocol/conformance/cases/wire.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/wire.js +130 -0
- package/dist/protocol/conformance/cases/wire.js.map +1 -0
- package/dist/protocol/conformance/cases/writes.d.ts +3 -0
- package/dist/protocol/conformance/cases/writes.d.ts.map +1 -0
- package/dist/protocol/conformance/cases/writes.js +278 -0
- package/dist/protocol/conformance/cases/writes.js.map +1 -0
- package/dist/protocol/conformance/contentHashFixtures.d.ts +51 -0
- package/dist/protocol/conformance/contentHashFixtures.d.ts.map +1 -0
- package/dist/protocol/conformance/contentHashFixtures.js +94 -0
- package/dist/protocol/conformance/contentHashFixtures.js.map +1 -0
- package/dist/protocol/conformance/context.d.ts +100 -0
- package/dist/protocol/conformance/context.d.ts.map +1 -0
- package/dist/protocol/conformance/context.js +155 -0
- package/dist/protocol/conformance/context.js.map +1 -0
- package/dist/protocol/conformance/index.d.ts +32 -0
- package/dist/protocol/conformance/index.d.ts.map +1 -0
- package/dist/protocol/conformance/index.js +90 -0
- package/dist/protocol/conformance/index.js.map +1 -0
- package/dist/protocol/errors.d.ts +85 -0
- package/dist/protocol/errors.d.ts.map +1 -0
- package/dist/protocol/errors.js +62 -0
- package/dist/protocol/errors.js.map +1 -0
- package/dist/protocol/index.d.ts +28 -0
- package/dist/protocol/index.d.ts.map +1 -0
- package/dist/protocol/index.js +28 -0
- package/dist/protocol/index.js.map +1 -0
- package/dist/protocol/keys.d.ts +101 -0
- package/dist/protocol/keys.d.ts.map +1 -0
- package/dist/protocol/keys.js +223 -0
- package/dist/protocol/keys.js.map +1 -0
- package/dist/protocol/params.d.ts +10 -0
- package/dist/protocol/params.d.ts.map +1 -0
- package/dist/protocol/params.js +54 -0
- package/dist/protocol/params.js.map +1 -0
- package/dist/protocol/secrets.d.ts +22 -0
- package/dist/protocol/secrets.d.ts.map +1 -0
- package/dist/protocol/secrets.js +200 -0
- package/dist/protocol/secrets.js.map +1 -0
- package/dist/protocol/server/assets.d.ts +20 -0
- package/dist/protocol/server/assets.d.ts.map +1 -0
- package/dist/protocol/server/assets.js +77 -0
- package/dist/protocol/server/assets.js.map +1 -0
- package/dist/protocol/server/auth.d.ts +31 -0
- package/dist/protocol/server/auth.d.ts.map +1 -0
- package/dist/protocol/server/auth.js +32 -0
- package/dist/protocol/server/auth.js.map +1 -0
- package/dist/protocol/server/bodyCache.d.ts +28 -0
- package/dist/protocol/server/bodyCache.d.ts.map +1 -0
- package/dist/protocol/server/bodyCache.js +75 -0
- package/dist/protocol/server/bodyCache.js.map +1 -0
- package/dist/protocol/server/content.d.ts +44 -0
- package/dist/protocol/server/content.d.ts.map +1 -0
- package/dist/protocol/server/content.js +132 -0
- package/dist/protocol/server/content.js.map +1 -0
- package/dist/protocol/server/core.d.ts +63 -0
- package/dist/protocol/server/core.d.ts.map +1 -0
- package/dist/protocol/server/core.js +77 -0
- package/dist/protocol/server/core.js.map +1 -0
- package/dist/protocol/server/handler.d.ts +5 -0
- package/dist/protocol/server/handler.d.ts.map +1 -0
- package/dist/protocol/server/handler.js +70 -0
- package/dist/protocol/server/handler.js.map +1 -0
- package/dist/protocol/server/http.d.ts +24 -0
- package/dist/protocol/server/http.d.ts.map +1 -0
- package/dist/protocol/server/http.js +133 -0
- package/dist/protocol/server/http.js.map +1 -0
- package/dist/protocol/server/index.d.ts +11 -0
- package/dist/protocol/server/index.d.ts.map +1 -0
- package/dist/protocol/server/index.js +9 -0
- package/dist/protocol/server/index.js.map +1 -0
- package/dist/protocol/server/methods/apply.d.ts +4 -0
- package/dist/protocol/server/methods/apply.d.ts.map +1 -0
- package/dist/protocol/server/methods/apply.js +275 -0
- package/dist/protocol/server/methods/apply.js.map +1 -0
- package/dist/protocol/server/methods/read.d.ts +14 -0
- package/dist/protocol/server/methods/read.d.ts.map +1 -0
- package/dist/protocol/server/methods/read.js +132 -0
- package/dist/protocol/server/methods/read.js.map +1 -0
- package/dist/protocol/server/rpc.d.ts +7 -0
- package/dist/protocol/server/rpc.d.ts.map +1 -0
- package/dist/protocol/server/rpc.js +115 -0
- package/dist/protocol/server/rpc.js.map +1 -0
- package/dist/protocol/storage/fs/hash.d.ts +8 -0
- package/dist/protocol/storage/fs/hash.d.ts.map +1 -0
- package/dist/protocol/storage/fs/hash.js +20 -0
- package/dist/protocol/storage/fs/hash.js.map +1 -0
- package/dist/protocol/storage/fs/index.d.ts +30 -0
- package/dist/protocol/storage/fs/index.d.ts.map +1 -0
- package/dist/protocol/storage/fs/index.js +301 -0
- package/dist/protocol/storage/fs/index.js.map +1 -0
- package/dist/protocol/storage/fs/lock.d.ts +8 -0
- package/dist/protocol/storage/fs/lock.d.ts.map +1 -0
- package/dist/protocol/storage/fs/lock.js +61 -0
- package/dist/protocol/storage/fs/lock.js.map +1 -0
- package/dist/protocol/storage/fs/transaction.d.ts +19 -0
- package/dist/protocol/storage/fs/transaction.d.ts.map +1 -0
- package/dist/protocol/storage/fs/transaction.js +174 -0
- package/dist/protocol/storage/fs/transaction.js.map +1 -0
- package/dist/protocol/storage/fs/unsupported.d.ts +10 -0
- package/dist/protocol/storage/fs/unsupported.d.ts.map +1 -0
- package/dist/protocol/storage/fs/unsupported.js +4 -0
- package/dist/protocol/storage/fs/unsupported.js.map +1 -0
- package/dist/protocol/storage/memory.d.ts +40 -0
- package/dist/protocol/storage/memory.d.ts.map +1 -0
- package/dist/protocol/storage/memory.js +179 -0
- package/dist/protocol/storage/memory.js.map +1 -0
- package/dist/protocol/storage.d.ts +178 -0
- package/dist/protocol/storage.d.ts.map +1 -0
- package/dist/protocol/storage.js +29 -0
- package/dist/protocol/storage.js.map +1 -0
- package/dist/protocol/types.d.ts +194 -0
- package/dist/protocol/types.d.ts.map +1 -0
- package/dist/protocol/types.js +31 -0
- package/dist/protocol/types.js.map +1 -0
- package/dist/v8/analytics.d.ts +31 -0
- package/dist/v8/analytics.d.ts.map +1 -0
- package/dist/v8/analytics.js +46 -0
- package/dist/v8/analytics.js.map +1 -0
- package/dist/v8/background.d.ts +26 -0
- package/dist/v8/background.d.ts.map +1 -0
- package/dist/v8/background.js +95 -0
- package/dist/v8/background.js.map +1 -0
- package/dist/v8/builtins/data.d.ts +15 -0
- package/dist/v8/builtins/data.d.ts.map +1 -0
- package/dist/v8/builtins/data.js +18 -0
- package/dist/v8/builtins/data.js.map +1 -0
- package/dist/v8/builtins/index.d.ts +9 -0
- package/dist/v8/builtins/index.d.ts.map +1 -0
- package/dist/v8/builtins/index.js +24 -0
- package/dist/v8/builtins/index.js.map +1 -0
- package/dist/v8/builtins/lazy.d.ts +17 -0
- package/dist/v8/builtins/lazy.d.ts.map +1 -0
- package/dist/v8/builtins/lazy.js +13 -0
- package/dist/v8/builtins/lazy.js.map +1 -0
- package/dist/v8/builtins/legacy.d.ts +41 -0
- package/dist/v8/builtins/legacy.d.ts.map +1 -0
- package/dist/v8/builtins/legacy.js +62 -0
- package/dist/v8/builtins/legacy.js.map +1 -0
- package/dist/v8/builtins/matchers.d.ts +19 -0
- package/dist/v8/builtins/matchers.d.ts.map +1 -0
- package/dist/v8/builtins/matchers.js +24 -0
- package/dist/v8/builtins/matchers.js.map +1 -0
- package/dist/v8/builtins/multivariate.d.ts +15 -0
- package/dist/v8/builtins/multivariate.d.ts.map +1 -0
- package/dist/v8/builtins/multivariate.js +18 -0
- package/dist/v8/builtins/multivariate.js.map +1 -0
- package/dist/v8/builtins/secret.d.ts +7 -0
- package/dist/v8/builtins/secret.d.ts.map +1 -0
- package/dist/v8/builtins/secret.js +68 -0
- package/dist/v8/builtins/secret.js.map +1 -0
- package/dist/v8/canonical.d.ts +70 -0
- package/dist/v8/canonical.d.ts.map +1 -0
- package/dist/v8/canonical.js +130 -0
- package/dist/v8/canonical.js.map +1 -0
- package/dist/v8/ciphertext.d.ts +58 -0
- package/dist/v8/ciphertext.d.ts.map +1 -0
- package/dist/v8/ciphertext.js +134 -0
- package/dist/v8/ciphertext.js.map +1 -0
- package/dist/v8/cli/builtins.d.ts +11 -0
- package/dist/v8/cli/builtins.d.ts.map +1 -0
- package/dist/v8/cli/builtins.js +18 -0
- package/dist/v8/cli/builtins.js.map +1 -0
- package/dist/v8/cli/check/index.d.ts +41 -0
- package/dist/v8/cli/check/index.d.ts.map +1 -0
- package/dist/v8/cli/check/index.js +713 -0
- package/dist/v8/cli/check/index.js.map +1 -0
- package/dist/v8/cli/check/messages.d.ts +24 -0
- package/dist/v8/cli/check/messages.d.ts.map +1 -0
- package/dist/v8/cli/check/messages.js +150 -0
- package/dist/v8/cli/check/messages.js.map +1 -0
- package/dist/v8/cli/content.d.ts +60 -0
- package/dist/v8/cli/content.d.ts.map +1 -0
- package/dist/v8/cli/content.js +231 -0
- package/dist/v8/cli/content.js.map +1 -0
- package/dist/v8/cli/index.d.ts +18 -0
- package/dist/v8/cli/index.d.ts.map +1 -0
- package/dist/v8/cli/index.js +18 -0
- package/dist/v8/cli/index.js.map +1 -0
- package/dist/v8/cli/log.d.ts +9 -0
- package/dist/v8/cli/log.d.ts.map +1 -0
- package/dist/v8/cli/log.js +11 -0
- package/dist/v8/cli/log.js.map +1 -0
- package/dist/v8/cli/main.d.ts +2 -0
- package/dist/v8/cli/main.d.ts.map +1 -0
- package/dist/v8/cli/main.js +9 -0
- package/dist/v8/cli/main.js.map +1 -0
- package/dist/v8/cli/root.d.ts +28 -0
- package/dist/v8/cli/root.d.ts.map +1 -0
- package/dist/v8/cli/root.js +64 -0
- package/dist/v8/cli/root.js.map +1 -0
- package/dist/v8/cli/run.d.ts +13 -0
- package/dist/v8/cli/run.d.ts.map +1 -0
- package/dist/v8/cli/run.js +210 -0
- package/dist/v8/cli/run.js.map +1 -0
- package/dist/v8/cli/schema/builtinSchemas.d.ts +22 -0
- package/dist/v8/cli/schema/builtinSchemas.d.ts.map +1 -0
- package/dist/v8/cli/schema/builtinSchemas.js +213 -0
- package/dist/v8/cli/schema/builtinSchemas.js.map +1 -0
- package/dist/v8/cli/schema/generate.d.ts +50 -0
- package/dist/v8/cli/schema/generate.d.ts.map +1 -0
- package/dist/v8/cli/schema/generate.js +415 -0
- package/dist/v8/cli/schema/generate.js.map +1 -0
- package/dist/v8/cli/schema/index.d.ts +21 -0
- package/dist/v8/cli/schema/index.d.ts.map +1 -0
- package/dist/v8/cli/schema/index.js +51 -0
- package/dist/v8/cli/schema/index.js.map +1 -0
- package/dist/v8/cli/schema/tsProgram.d.ts +126 -0
- package/dist/v8/cli/schema/tsProgram.d.ts.map +1 -0
- package/dist/v8/cli/schema/tsProgram.js +435 -0
- package/dist/v8/cli/schema/tsProgram.js.map +1 -0
- package/dist/v8/cli/schema/typeToSchema.d.ts +94 -0
- package/dist/v8/cli/schema/typeToSchema.d.ts.map +1 -0
- package/dist/v8/cli/schema/typeToSchema.js +752 -0
- package/dist/v8/cli/schema/typeToSchema.js.map +1 -0
- package/dist/v8/cli/serve/server.d.ts +31 -0
- package/dist/v8/cli/serve/server.d.ts.map +1 -0
- package/dist/v8/cli/serve/server.js +247 -0
- package/dist/v8/cli/serve/server.js.map +1 -0
- package/dist/v8/cli/watch.d.ts +20 -0
- package/dist/v8/cli/watch.d.ts.map +1 -0
- package/dist/v8/cli/watch.js +79 -0
- package/dist/v8/cli/watch.js.map +1 -0
- package/dist/v8/client.d.ts +20 -0
- package/dist/v8/client.d.ts.map +1 -0
- package/dist/v8/client.js +115 -0
- package/dist/v8/client.js.map +1 -0
- package/dist/v8/cms.d.ts +9 -0
- package/dist/v8/cms.d.ts.map +1 -0
- package/dist/v8/cms.js +217 -0
- package/dist/v8/cms.js.map +1 -0
- package/dist/v8/content.d.ts +51 -0
- package/dist/v8/content.d.ts.map +1 -0
- package/dist/v8/content.js +218 -0
- package/dist/v8/content.js.map +1 -0
- package/dist/v8/draft.d.ts +48 -0
- package/dist/v8/draft.d.ts.map +1 -0
- package/dist/v8/draft.js +195 -0
- package/dist/v8/draft.js.map +1 -0
- package/dist/v8/errors.d.ts +21 -0
- package/dist/v8/errors.d.ts.map +1 -0
- package/dist/v8/errors.js +39 -0
- package/dist/v8/errors.js.map +1 -0
- package/dist/v8/fetch.d.ts +26 -0
- package/dist/v8/fetch.d.ts.map +1 -0
- package/dist/v8/fetch.js +98 -0
- package/dist/v8/fetch.js.map +1 -0
- package/dist/v8/identity.d.ts +19 -0
- package/dist/v8/identity.d.ts.map +1 -0
- package/dist/v8/identity.js +54 -0
- package/dist/v8/identity.js.map +1 -0
- package/dist/v8/index.d.ts +11 -0
- package/dist/v8/index.d.ts.map +1 -0
- package/dist/v8/index.js +10 -0
- package/dist/v8/index.js.map +1 -0
- package/dist/v8/json.d.ts +19 -0
- package/dist/v8/json.d.ts.map +1 -0
- package/dist/v8/json.js +65 -0
- package/dist/v8/json.js.map +1 -0
- package/dist/v8/matchRoute.d.ts +30 -0
- package/dist/v8/matchRoute.d.ts.map +1 -0
- package/dist/v8/matchRoute.js +175 -0
- package/dist/v8/matchRoute.js.map +1 -0
- package/dist/v8/remoteLoader.d.ts +16 -0
- package/dist/v8/remoteLoader.d.ts.map +1 -0
- package/dist/v8/remoteLoader.js +427 -0
- package/dist/v8/remoteLoader.js.map +1 -0
- package/dist/v8/resolver.d.ts +34 -0
- package/dist/v8/resolver.d.ts.map +1 -0
- package/dist/v8/resolver.js +219 -0
- package/dist/v8/resolver.js.map +1 -0
- package/dist/v8/secrets.d.ts +9 -0
- package/dist/v8/secrets.d.ts.map +1 -0
- package/dist/v8/secrets.js +14 -0
- package/dist/v8/secrets.js.map +1 -0
- package/dist/v8/telemetry.d.ts +61 -0
- package/dist/v8/telemetry.d.ts.map +1 -0
- package/dist/v8/telemetry.js +460 -0
- package/dist/v8/telemetry.js.map +1 -0
- package/dist/v8/types.d.ts +226 -0
- package/dist/v8/types.d.ts.map +1 -0
- package/dist/v8/types.js +2 -0
- package/dist/v8/types.js.map +1 -0
- package/dist/v8/variants.d.ts +3 -0
- package/dist/v8/variants.d.ts.map +1 -0
- package/dist/v8/variants.js +65 -0
- package/dist/v8/variants.js.map +1 -0
- package/package.json +64 -18
- package/src/index.ts +1 -1
- package/src/protocol/canonical.ts +1 -1
- package/src/protocol/ciphertext.ts +1 -1
- package/src/protocol/client.ts +2 -2
- package/src/protocol/conformance/cases/assets.ts +3 -3
- package/src/protocol/conformance/cases/guards.ts +4 -4
- package/src/protocol/conformance/cases/reads.ts +4 -4
- package/src/protocol/conformance/cases/types.ts +1 -1
- package/src/protocol/conformance/cases/wire.ts +4 -4
- package/src/protocol/conformance/cases/writes.ts +4 -4
- package/src/protocol/conformance/contentHashFixtures.ts +57 -0
- package/src/protocol/conformance/context.ts +4 -4
- package/src/protocol/conformance/index.ts +15 -10
- package/src/protocol/index.ts +14 -7
- package/src/protocol/params.ts +2 -2
- package/src/protocol/secrets.ts +3 -3
- package/src/protocol/server/assets.ts +6 -6
- package/src/protocol/server/auth.ts +1 -1
- package/src/protocol/server/content.ts +5 -5
- package/src/protocol/server/core.ts +12 -6
- package/src/protocol/server/handler.ts +6 -6
- package/src/protocol/server/http.ts +1 -1
- package/src/protocol/server/index.ts +3 -3
- package/src/protocol/server/methods/apply.ts +9 -9
- package/src/protocol/server/methods/read.ts +5 -5
- package/src/protocol/server/rpc.ts +6 -6
- package/src/protocol/storage/fs/index.ts +7 -7
- package/src/protocol/storage/fs/lock.ts +1 -1
- package/src/protocol/storage/fs/unsupported.ts +2 -2
- package/src/protocol/storage/memory.ts +4 -4
- package/src/protocol/storage.ts +1 -1
- package/src/v8/analytics.ts +2 -2
- package/src/v8/builtins/data.ts +1 -1
- package/src/v8/builtins/index.ts +6 -6
- package/src/v8/builtins/lazy.ts +1 -1
- package/src/v8/builtins/legacy.ts +1 -1
- package/src/v8/builtins/multivariate.ts +1 -1
- package/src/v8/builtins/secret.ts +2 -2
- package/src/v8/canonical.ts +36 -0
- package/src/v8/cli/builtins.ts +2 -2
- package/src/v8/cli/check/index.ts +11 -11
- package/src/v8/cli/content.ts +6 -6
- package/src/v8/cli/index.ts +7 -7
- package/src/v8/cli/main.ts +1 -1
- package/src/v8/cli/run.ts +7 -7
- package/src/v8/cli/schema/builtinSchemas.ts +1 -1
- package/src/v8/cli/schema/generate.ts +8 -7
- package/src/v8/cli/schema/index.ts +4 -4
- package/src/v8/cli/schema/tsProgram.ts +18 -1
- package/src/v8/cli/schema/typeToSchema.ts +100 -4
- package/src/v8/cli/serve/server.ts +9 -9
- package/src/v8/client.ts +5 -5
- package/src/v8/cms.ts +23 -11
- package/src/v8/content.ts +58 -22
- package/src/v8/draft.ts +75 -6
- package/src/v8/errors.ts +1 -1
- package/src/v8/fetch.ts +1 -1
- package/src/v8/identity.ts +1 -1
- package/src/v8/index.ts +5 -5
- package/src/v8/matchRoute.ts +1 -1
- package/src/v8/remoteLoader.ts +246 -26
- package/src/v8/resolver.ts +6 -6
- package/src/v8/secrets.ts +1 -1
- package/src/v8/telemetry.ts +5 -5
- package/src/v8/types.ts +14 -1
- package/src/v8/variants.ts +61 -0
package/dist/v8/cms.js
ADDED
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `createCMS`: the block map plus the content, created once per process.
|
|
3
|
+
*
|
|
4
|
+
* Instances are process-wide singletons stored on `globalThis` under a
|
|
5
|
+
* `Symbol.for("decocms.blocks.cms:…")` key derived from the configuration, so
|
|
6
|
+
* a package loaded twice (two bundles, a dev reload) still shares one content
|
|
7
|
+
* cache. See /next/api-reference#one-instance-per-process.
|
|
8
|
+
*/
|
|
9
|
+
import { runInBackground } from "./background.js";
|
|
10
|
+
import { builtIns } from "./builtins/index.js";
|
|
11
|
+
import { secretBlock } from "./builtins/secret.js";
|
|
12
|
+
import { CMSClient } from "./client.js";
|
|
13
|
+
import { ContentStore, isLoader, isSnapshot } from "./content.js";
|
|
14
|
+
import { parseDraftPointer } from "./draft.js";
|
|
15
|
+
import { clearGlobals, contentIdentity, fnv1a, readEnv } from "./identity.js";
|
|
16
|
+
import { remoteLoader, resetRemoteLoaders } from "./remoteLoader.js";
|
|
17
|
+
import { resolveDestination, setCurrentTelemetry, TelemetryPipeline } from "./telemetry.js";
|
|
18
|
+
import { forceVariants } from "./variants.js";
|
|
19
|
+
const INSTANCE_PREFIX = "decocms.blocks.cms:";
|
|
20
|
+
const MIN_INTERVAL = 60_000;
|
|
21
|
+
/** Each check runs one interval, plus or minus up to this much, after the previous one. */
|
|
22
|
+
const JITTER = 10_000;
|
|
23
|
+
class CMSInstance {
|
|
24
|
+
config;
|
|
25
|
+
fingerprint;
|
|
26
|
+
#store;
|
|
27
|
+
#interval;
|
|
28
|
+
#warned = new Set();
|
|
29
|
+
/** The built-ins with a `secret` that holds this instance's key (the first call's). */
|
|
30
|
+
#builtIns;
|
|
31
|
+
#telemetry;
|
|
32
|
+
#blocks;
|
|
33
|
+
/**
|
|
34
|
+
* When the next check is due. The first is on the first `forRelease()` or `forDraft()`, not
|
|
35
|
+
* at construction: Workers read `Date.now()` as 0 at module scope.
|
|
36
|
+
*/
|
|
37
|
+
#nextCheck;
|
|
38
|
+
constructor(config, interval) {
|
|
39
|
+
this.config = config;
|
|
40
|
+
this.#blocks = config.blocks;
|
|
41
|
+
this.#interval = interval;
|
|
42
|
+
this.#store = new ContentStore(contentOf(config));
|
|
43
|
+
this.fingerprint = fingerprintOf(config, interval);
|
|
44
|
+
const destination = resolveDestination(config.telemetry, config.site);
|
|
45
|
+
if (destination !== null) {
|
|
46
|
+
this.#telemetry = new TelemetryPipeline(destination);
|
|
47
|
+
setCurrentTelemetry(this.#telemetry);
|
|
48
|
+
}
|
|
49
|
+
// Decrypted values never leave in telemetry: the pipeline redacts each one.
|
|
50
|
+
const telemetry = this.#telemetry;
|
|
51
|
+
const secret = secretBlock(config.secrets?.key, (value) => telemetry?.redact(value));
|
|
52
|
+
this.#builtIns = Object.freeze({ ...builtIns, secret });
|
|
53
|
+
}
|
|
54
|
+
forRelease() {
|
|
55
|
+
this.#scheduleUpdate();
|
|
56
|
+
const telemetry = this.#telemetry;
|
|
57
|
+
if (telemetry === undefined)
|
|
58
|
+
return this.#client(() => this.#store.release());
|
|
59
|
+
return this.#client(() => this.#store.release().then((snapshot) => {
|
|
60
|
+
telemetry.useRelease(snapshot);
|
|
61
|
+
return snapshot;
|
|
62
|
+
}));
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* The draft, with the variants the pointer forces (even over a source with no
|
|
66
|
+
* drafts). A draft inherits local production, so it schedules the same
|
|
67
|
+
* background release check `forRelease()` does (never in front of the draft).
|
|
68
|
+
*/
|
|
69
|
+
forDraft(pointer) {
|
|
70
|
+
this.#scheduleUpdate();
|
|
71
|
+
const variants = parseDraftPointer(pointer)?.variants;
|
|
72
|
+
if (variants === undefined)
|
|
73
|
+
return this.#client(() => this.#store.draft(pointer));
|
|
74
|
+
return this.#client(() => this.#store.draft(pointer).then((snapshot) => forceVariants(snapshot, variants)));
|
|
75
|
+
}
|
|
76
|
+
forRevision(revision) {
|
|
77
|
+
return this.#client(() => this.#store.revision(revision));
|
|
78
|
+
}
|
|
79
|
+
update() {
|
|
80
|
+
this.#nextCheck = this.#due();
|
|
81
|
+
return this.#store.update();
|
|
82
|
+
}
|
|
83
|
+
/** A later `createCMS` call with the same key hands in its (possibly hot-reloaded) map and content. */
|
|
84
|
+
adopt(config) {
|
|
85
|
+
this.#blocks = config.blocks;
|
|
86
|
+
this.#store.replace(contentOf(config));
|
|
87
|
+
}
|
|
88
|
+
#client(load) {
|
|
89
|
+
return new CMSClient({
|
|
90
|
+
load,
|
|
91
|
+
blocks: this.#blocks,
|
|
92
|
+
builtIns: this.#builtIns,
|
|
93
|
+
onCollision: (name) => this.#warnCollision(name),
|
|
94
|
+
telemetry: this.#telemetry?.forClient(),
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Checks a content source with `update()` on first use and then every
|
|
99
|
+
* `interval` (± up to 10 s), at an idle moment, never in front of a request.
|
|
100
|
+
*/
|
|
101
|
+
#scheduleUpdate() {
|
|
102
|
+
if (!this.#store.updatable)
|
|
103
|
+
return;
|
|
104
|
+
if (this.#nextCheck !== undefined && Date.now() < this.#nextCheck)
|
|
105
|
+
return;
|
|
106
|
+
this.#nextCheck = this.#due();
|
|
107
|
+
runInBackground(() => this.#store.update());
|
|
108
|
+
}
|
|
109
|
+
#due() {
|
|
110
|
+
return Date.now() + this.#interval + (Math.random() * 2 - 1) * JITTER;
|
|
111
|
+
}
|
|
112
|
+
#warnCollision(name) {
|
|
113
|
+
if (this.#warned.has(name))
|
|
114
|
+
return;
|
|
115
|
+
this.#warned.add(name);
|
|
116
|
+
console.warn(`[decocms/blocks] the saved block "${name}" has the name of a block type, built-in or alias; ` +
|
|
117
|
+
"the function wins. Rename the saved block (deco check reports this).");
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Creates the CMS, or returns the instance this configuration already has.
|
|
122
|
+
* Create it once, at module scope, and ask it for a client per request.
|
|
123
|
+
*/
|
|
124
|
+
export function createCMS(config) {
|
|
125
|
+
validate(config);
|
|
126
|
+
// A remoteLoader passed as `content` carries the `interval` it was created with.
|
|
127
|
+
const own = config.content.interval;
|
|
128
|
+
const interval = resolveInterval(config.interval ?? (typeof own === "number" ? own : undefined));
|
|
129
|
+
const key = Symbol.for(INSTANCE_PREFIX + identityOf(config));
|
|
130
|
+
const store = globalThis;
|
|
131
|
+
const existing = store[key];
|
|
132
|
+
if (existing instanceof Object && typeof existing.adopt === "function") {
|
|
133
|
+
warnOnConflict(existing.fingerprint, fingerprintOf(config, interval));
|
|
134
|
+
existing.adopt(config);
|
|
135
|
+
return existing;
|
|
136
|
+
}
|
|
137
|
+
const instance = new CMSInstance(config, interval);
|
|
138
|
+
store[key] = instance;
|
|
139
|
+
return instance;
|
|
140
|
+
}
|
|
141
|
+
/** Clears every stored CMS instance, so a test starts clean. */
|
|
142
|
+
export function resetForTests() {
|
|
143
|
+
clearGlobals(INSTANCE_PREFIX);
|
|
144
|
+
resetRemoteLoaders();
|
|
145
|
+
setCurrentTelemetry(undefined);
|
|
146
|
+
}
|
|
147
|
+
/** With `site` and `token`, the content is the fallback of hosted releases and drafts. */
|
|
148
|
+
function contentOf(config) {
|
|
149
|
+
if (!config.site || !config.token)
|
|
150
|
+
return config.content;
|
|
151
|
+
return remoteLoader(config.content, { site: config.site, token: config.token });
|
|
152
|
+
}
|
|
153
|
+
function validate(config) {
|
|
154
|
+
if (config === null || typeof config !== "object") {
|
|
155
|
+
throw new TypeError("createCMS: expected a config object");
|
|
156
|
+
}
|
|
157
|
+
if (config.blocks === null || typeof config.blocks !== "object") {
|
|
158
|
+
throw new TypeError("createCMS: `blocks` must be your block map (an object of functions)");
|
|
159
|
+
}
|
|
160
|
+
if (!isLoader(config.content) && !isSnapshot(config.content)) {
|
|
161
|
+
throw new TypeError("createCMS: `content` must be the content module ({ revision, blocks }) or a loader with load()");
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
function resolveInterval(configured) {
|
|
165
|
+
const env = readEnv("DECO_CONTENT_INTERVAL");
|
|
166
|
+
const raw = configured ?? (env ? Number(env) : MIN_INTERVAL);
|
|
167
|
+
if (!Number.isFinite(raw))
|
|
168
|
+
return MIN_INTERVAL;
|
|
169
|
+
if (raw < MIN_INTERVAL) {
|
|
170
|
+
console.warn(`[decocms/blocks] interval ${raw} ms is below the minimum; raised to ${MIN_INTERVAL} ms.`);
|
|
171
|
+
return MIN_INTERVAL;
|
|
172
|
+
}
|
|
173
|
+
return raw;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* The instance key: the content's identity (never its revision, so a hot
|
|
177
|
+
* reload keeps the instance) and, with the hosted Deco CMS, the site and a
|
|
178
|
+
* hash of the token, which never appears in the global symbol registry.
|
|
179
|
+
*
|
|
180
|
+
* A content module is identified by the `.deco` folder it was generated from
|
|
181
|
+
* (its `root`). One without a `root` is identified by the object itself, so
|
|
182
|
+
* two such modules never share an instance; a hot reload of one then gets a
|
|
183
|
+
* new instance instead of updating the old.
|
|
184
|
+
*/
|
|
185
|
+
function identityOf(config) {
|
|
186
|
+
const content = contentIdentity(config.content);
|
|
187
|
+
if (!config.site || !config.token)
|
|
188
|
+
return content;
|
|
189
|
+
return `${content}|site:${config.site}|token:${fnv1a(config.token)}`;
|
|
190
|
+
}
|
|
191
|
+
function fingerprintOf(config, interval) {
|
|
192
|
+
return {
|
|
193
|
+
interval,
|
|
194
|
+
telemetry: stableJson(config.telemetry ?? null),
|
|
195
|
+
secrets: config.secrets?.key ? fnv1a(config.secrets.key) : "",
|
|
196
|
+
};
|
|
197
|
+
}
|
|
198
|
+
function warnOnConflict(first, next) {
|
|
199
|
+
const conflicts = Object.keys(first).filter((name) => first[name] !== next[name]);
|
|
200
|
+
if (conflicts.length === 0)
|
|
201
|
+
return;
|
|
202
|
+
console.warn(`[decocms/blocks] createCMS was called again for the same content with different options ` +
|
|
203
|
+
`(${conflicts.join(", ")}); keeping the first instance's options.`);
|
|
204
|
+
}
|
|
205
|
+
function stableJson(value) {
|
|
206
|
+
if (Array.isArray(value))
|
|
207
|
+
return `[${value.map(stableJson).join(",")}]`;
|
|
208
|
+
if (value !== null && typeof value === "object") {
|
|
209
|
+
const record = value;
|
|
210
|
+
return `{${Object.keys(record)
|
|
211
|
+
.sort()
|
|
212
|
+
.map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)
|
|
213
|
+
.join(",")}}`;
|
|
214
|
+
}
|
|
215
|
+
return JSON.stringify(value) ?? "undefined";
|
|
216
|
+
}
|
|
217
|
+
//# sourceMappingURL=cms.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cms.js","sourceRoot":"","sources":["../../src/v8/cms.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { Loader, Snapshot } from "./types.ts";
|
|
2
|
+
export declare function isLoader(content: unknown): content is Loader;
|
|
3
|
+
export declare function isSnapshot(content: unknown): content is Snapshot;
|
|
4
|
+
export declare class ContentStore {
|
|
5
|
+
#private;
|
|
6
|
+
constructor(source: Snapshot | Loader);
|
|
7
|
+
/** Whether the source can change while the process runs (has `update()`). */
|
|
8
|
+
get updatable(): boolean;
|
|
9
|
+
/**
|
|
10
|
+
* The current release. A snapshot is the release; a loader with `update()`
|
|
11
|
+
* is loaded once and reloaded after an update; a loader without `update()`
|
|
12
|
+
* is asked on every call, since it's always current by construction.
|
|
13
|
+
*/
|
|
14
|
+
release(): Promise<Snapshot>;
|
|
15
|
+
/**
|
|
16
|
+
* The draft a pointer names. A snapshot has no drafts and ignores the
|
|
17
|
+
* pointer. A loader gets `load(pointer)` only for a pointer that parses,
|
|
18
|
+
* formatted again without its `__variant` parameters (so every variant of
|
|
19
|
+
* one draft shares one load); anything else is `LOADER_FAILED`, never a
|
|
20
|
+
* silent fallback to the release. A loaded draft is reused for a minute.
|
|
21
|
+
*/
|
|
22
|
+
draft(pointer: string): Promise<Snapshot>;
|
|
23
|
+
/** A release revision this store has served, or the release when it's unknown (drafts included). */
|
|
24
|
+
revision(revision: string): Promise<Snapshot>;
|
|
25
|
+
/** Asks the source for newer content; never throws, and concurrent calls share one check. */
|
|
26
|
+
update(): Promise<{
|
|
27
|
+
updated: boolean;
|
|
28
|
+
}>;
|
|
29
|
+
/**
|
|
30
|
+
* Swaps the content in place, for a hot reload that hands the same CMS a new
|
|
31
|
+
* content module. Any new object swaps, even with the same `revision`: an
|
|
32
|
+
* edited JSON file reloads without rerunning `deco content`, so the new
|
|
33
|
+
* module carries new `blocks` under the old revision.
|
|
34
|
+
*/
|
|
35
|
+
replace(source: Snapshot | Loader): void;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* A Map that forgets its least recently used entries past `limit`, counted by
|
|
39
|
+
* `size` (one per entry unless given).
|
|
40
|
+
*/
|
|
41
|
+
export declare class BoundedMap<K, V> {
|
|
42
|
+
#private;
|
|
43
|
+
readonly limit: number;
|
|
44
|
+
readonly size: (value: V) => number;
|
|
45
|
+
constructor(limit: number, size?: (value: V) => number);
|
|
46
|
+
get(key: K): V | undefined;
|
|
47
|
+
set(key: K, value: V): void;
|
|
48
|
+
delete(key: K): void;
|
|
49
|
+
clear(): void;
|
|
50
|
+
}
|
|
51
|
+
//# sourceMappingURL=content.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/v8/content.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAWnD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAM5D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,CAOhE;AAED,qBAAa,YAAY;;IASvB,YAAY,MAAM,EAAE,QAAQ,GAAG,MAAM,EAEpC;IAED,6EAA6E;IAC7E,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAa3B;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqBxC;IAED,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG5C;IAED,6FAA6F;IAC7F,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAuBtC;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAavC;CAuBF;AAMD;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC;;IAIxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM;IAFrC,YACW,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAgB,EAC3C;IAEJ,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAOzB;IAED,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAS1B;IAED,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAInB;IAED,KAAK,IAAI,IAAI,CAGZ;CACF"}
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The content side of a CMS: one source (the content module or a `Loader`),
|
|
3
|
+
* the caches every client shares, and the release revisions this process has
|
|
4
|
+
* served. Clients only ever see whole `{ revision, blocks }` snapshots.
|
|
5
|
+
*
|
|
6
|
+
* Drafts are never recorded as served: `forRevision(revision)` takes a
|
|
7
|
+
* revision string a client may hand back, so it must only ever reach published
|
|
8
|
+
* content, never a draft someone loaded with a pointer.
|
|
9
|
+
*/
|
|
10
|
+
import { formatDraftPointer, parseDraftPointer } from "./draft.js";
|
|
11
|
+
import { errors, isResolutionError } from "./errors.js";
|
|
12
|
+
import { isPlainObject } from "./json.js";
|
|
13
|
+
const SERVED_REVISIONS = 16;
|
|
14
|
+
/** Composed drafts kept per CMS (see /next/studio-implementation's initial limits). */
|
|
15
|
+
const CACHED_DRAFTS = 3;
|
|
16
|
+
/**
|
|
17
|
+
* How long a loaded draft is reused before `load(pointer)` runs again, so a
|
|
18
|
+
* loader's own checks (a hosted grant's expiry) apply on a warm server too.
|
|
19
|
+
*/
|
|
20
|
+
const DRAFT_TTL_MS = 60_000;
|
|
21
|
+
export function isLoader(content) {
|
|
22
|
+
return ((typeof content === "object" || typeof content === "function") &&
|
|
23
|
+
content !== null &&
|
|
24
|
+
typeof content.load === "function");
|
|
25
|
+
}
|
|
26
|
+
export function isSnapshot(content) {
|
|
27
|
+
return (isPlainObject(content) &&
|
|
28
|
+
typeof content.revision === "string" &&
|
|
29
|
+
isPlainObject(content.blocks) &&
|
|
30
|
+
(content.aliases === undefined || isPlainObject(content.aliases)));
|
|
31
|
+
}
|
|
32
|
+
export class ContentStore {
|
|
33
|
+
#source;
|
|
34
|
+
#release;
|
|
35
|
+
#updating;
|
|
36
|
+
#drafts = new BoundedMap(CACHED_DRAFTS);
|
|
37
|
+
#served = new BoundedMap(SERVED_REVISIONS);
|
|
38
|
+
constructor(source) {
|
|
39
|
+
this.#source = source;
|
|
40
|
+
}
|
|
41
|
+
/** Whether the source can change while the process runs (has `update()`). */
|
|
42
|
+
get updatable() {
|
|
43
|
+
return isLoader(this.#source) && typeof this.#source.update === "function";
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The current release. A snapshot is the release; a loader with `update()`
|
|
47
|
+
* is loaded once and reloaded after an update; a loader without `update()`
|
|
48
|
+
* is asked on every call, since it's always current by construction.
|
|
49
|
+
*/
|
|
50
|
+
release() {
|
|
51
|
+
const source = this.#source;
|
|
52
|
+
if (!isLoader(source))
|
|
53
|
+
return Promise.resolve(this.#serve(source));
|
|
54
|
+
if (!this.updatable)
|
|
55
|
+
return this.#load(source, null).then((snapshot) => this.#serve(snapshot));
|
|
56
|
+
if (this.#release === undefined) {
|
|
57
|
+
const pending = this.#load(source, null).then((snapshot) => this.#serve(snapshot));
|
|
58
|
+
this.#release = pending;
|
|
59
|
+
// A failed load isn't cached: the next client tries again.
|
|
60
|
+
pending.catch(() => {
|
|
61
|
+
if (this.#release === pending)
|
|
62
|
+
this.#release = undefined;
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
return this.#release;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* The draft a pointer names. A snapshot has no drafts and ignores the
|
|
69
|
+
* pointer. A loader gets `load(pointer)` only for a pointer that parses,
|
|
70
|
+
* formatted again without its `__variant` parameters (so every variant of
|
|
71
|
+
* one draft shares one load); anything else is `LOADER_FAILED`, never a
|
|
72
|
+
* silent fallback to the release. A loaded draft is reused for a minute.
|
|
73
|
+
*/
|
|
74
|
+
draft(pointer) {
|
|
75
|
+
const source = this.#source;
|
|
76
|
+
if (!isLoader(source))
|
|
77
|
+
return this.release();
|
|
78
|
+
const parsed = parseDraftPointer(pointer);
|
|
79
|
+
if (parsed === null) {
|
|
80
|
+
return Promise.reject(errors.loaderFailed(`invalid draft pointer "${truncate(pointer)}"`));
|
|
81
|
+
}
|
|
82
|
+
// The draft itself, without the variants a preview forces: those apply per client.
|
|
83
|
+
const key = formatDraftPointer({
|
|
84
|
+
host: parsed.host,
|
|
85
|
+
path: parsed.path,
|
|
86
|
+
version: parsed.version,
|
|
87
|
+
});
|
|
88
|
+
const cached = this.#drafts.get(key);
|
|
89
|
+
if (cached !== undefined && Date.now() - cached.at < DRAFT_TTL_MS)
|
|
90
|
+
return cached.pending;
|
|
91
|
+
const entry = { pending: this.#load(source, key), at: Date.now() };
|
|
92
|
+
this.#drafts.set(key, entry);
|
|
93
|
+
entry.pending.catch(() => {
|
|
94
|
+
if (this.#drafts.get(key) === entry)
|
|
95
|
+
this.#drafts.delete(key);
|
|
96
|
+
});
|
|
97
|
+
return entry.pending;
|
|
98
|
+
}
|
|
99
|
+
/** A release revision this store has served, or the release when it's unknown (drafts included). */
|
|
100
|
+
revision(revision) {
|
|
101
|
+
const served = this.#served.get(revision);
|
|
102
|
+
return served === undefined ? this.release() : Promise.resolve(served);
|
|
103
|
+
}
|
|
104
|
+
/** Asks the source for newer content; never throws, and concurrent calls share one check. */
|
|
105
|
+
update() {
|
|
106
|
+
const source = this.#source;
|
|
107
|
+
if (!isLoader(source) || typeof source.update !== "function") {
|
|
108
|
+
return Promise.resolve({ updated: false });
|
|
109
|
+
}
|
|
110
|
+
this.#updating ??= (async () => {
|
|
111
|
+
try {
|
|
112
|
+
const result = await source.update?.();
|
|
113
|
+
const updated = result?.updated === true;
|
|
114
|
+
if (updated) {
|
|
115
|
+
this.#release = undefined;
|
|
116
|
+
// A loader that ignores the pointer hands back the release as the
|
|
117
|
+
// draft; that copy is as stale as the release now.
|
|
118
|
+
this.#drafts.clear();
|
|
119
|
+
}
|
|
120
|
+
return { updated };
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
return { updated: false };
|
|
124
|
+
}
|
|
125
|
+
finally {
|
|
126
|
+
this.#updating = undefined;
|
|
127
|
+
}
|
|
128
|
+
})();
|
|
129
|
+
return this.#updating;
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Swaps the content in place, for a hot reload that hands the same CMS a new
|
|
133
|
+
* content module. Any new object swaps, even with the same `revision`: an
|
|
134
|
+
* edited JSON file reloads without rerunning `deco content`, so the new
|
|
135
|
+
* module carries new `blocks` under the old revision.
|
|
136
|
+
*/
|
|
137
|
+
replace(source) {
|
|
138
|
+
const previous = this.#source;
|
|
139
|
+
if (source === previous) {
|
|
140
|
+
// The same loader (a hosted remoteLoader that adopted new fallback content): re-read it.
|
|
141
|
+
// Cached drafts were layered over the old content, so they go too.
|
|
142
|
+
this.#release = undefined;
|
|
143
|
+
this.#drafts.clear();
|
|
144
|
+
return;
|
|
145
|
+
}
|
|
146
|
+
if (isSnapshot(previous))
|
|
147
|
+
this.#served.delete(previous.revision);
|
|
148
|
+
this.#source = source;
|
|
149
|
+
this.#release = undefined;
|
|
150
|
+
this.#drafts.clear();
|
|
151
|
+
}
|
|
152
|
+
async #load(loader, pointer) {
|
|
153
|
+
let snapshot;
|
|
154
|
+
try {
|
|
155
|
+
snapshot = pointer === null ? await loader.load() : await loader.load(pointer);
|
|
156
|
+
}
|
|
157
|
+
catch (error) {
|
|
158
|
+
if (isResolutionError(error))
|
|
159
|
+
throw error;
|
|
160
|
+
throw errors.loaderFailed(pointer === null ? "the content loader failed" : "the draft couldn't load", error);
|
|
161
|
+
}
|
|
162
|
+
if (!isSnapshot(snapshot)) {
|
|
163
|
+
throw errors.loaderFailed("the content loader returned something other than a snapshot");
|
|
164
|
+
}
|
|
165
|
+
return snapshot;
|
|
166
|
+
}
|
|
167
|
+
#serve(snapshot) {
|
|
168
|
+
this.#served.set(snapshot.revision, snapshot);
|
|
169
|
+
return snapshot;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
function truncate(value) {
|
|
173
|
+
return value.length > 80 ? `${value.slice(0, 80)}…` : value;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* A Map that forgets its least recently used entries past `limit`, counted by
|
|
177
|
+
* `size` (one per entry unless given).
|
|
178
|
+
*/
|
|
179
|
+
export class BoundedMap {
|
|
180
|
+
limit;
|
|
181
|
+
size;
|
|
182
|
+
#map = new Map();
|
|
183
|
+
#total = 0;
|
|
184
|
+
constructor(limit, size = () => 1) {
|
|
185
|
+
this.limit = limit;
|
|
186
|
+
this.size = size;
|
|
187
|
+
}
|
|
188
|
+
get(key) {
|
|
189
|
+
const value = this.#map.get(key);
|
|
190
|
+
if (value !== undefined) {
|
|
191
|
+
this.#map.delete(key);
|
|
192
|
+
this.#map.set(key, value);
|
|
193
|
+
}
|
|
194
|
+
return value;
|
|
195
|
+
}
|
|
196
|
+
set(key, value) {
|
|
197
|
+
this.delete(key);
|
|
198
|
+
this.#map.set(key, value);
|
|
199
|
+
this.#total += this.size(value);
|
|
200
|
+
for (const [oldest, old] of this.#map) {
|
|
201
|
+
if (this.#total <= this.limit || oldest === key)
|
|
202
|
+
break;
|
|
203
|
+
this.#map.delete(oldest);
|
|
204
|
+
this.#total -= this.size(old);
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
delete(key) {
|
|
208
|
+
if (!this.#map.has(key))
|
|
209
|
+
return;
|
|
210
|
+
this.#total -= this.size(this.#map.get(key));
|
|
211
|
+
this.#map.delete(key);
|
|
212
|
+
}
|
|
213
|
+
clear() {
|
|
214
|
+
this.#map.clear();
|
|
215
|
+
this.#total = 0;
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
//# sourceMappingURL=content.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/v8/content.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Draft pointers (see /next/api-reference#draft-pointers): the string
|
|
3
|
+
* `<host[:port]><path[?query]>@<version>` that names a draft, and the two
|
|
4
|
+
* helpers that carry one from a `?__draft=` link into a cookie.
|
|
5
|
+
*
|
|
6
|
+
* The query's reserved `__variant` parameters are the variants a preview
|
|
7
|
+
* forces (`<block>@<path>=<index>`, URL-encoded, one per multivariate); the
|
|
8
|
+
* parser lifts them out of `path` into `variants`.
|
|
9
|
+
*/
|
|
10
|
+
import type { DraftPointer } from "./types.ts";
|
|
11
|
+
/** The draft cookie's name, for frameworks whose cookie API has no Request (Next.js `cookies()`). */
|
|
12
|
+
export declare const DRAFT_COOKIE = "deco-draft";
|
|
13
|
+
/**
|
|
14
|
+
* Parses a pointer, strictly: `null` on a scheme, a stray `@`, an unrooted
|
|
15
|
+
* path, an odd character in the host or version, or a port out of range. The
|
|
16
|
+
* host is lowercased (DNS names are case-insensitive); path and version are
|
|
17
|
+
* kept as they are.
|
|
18
|
+
*/
|
|
19
|
+
export declare function parseDraftPointer(raw: string | null | undefined): DraftPointer | null;
|
|
20
|
+
/**
|
|
21
|
+
* Builds a pointer from its parts: the inverse of {@link parseDraftPointer}.
|
|
22
|
+
* Throws a `TypeError` when the parts can't form a pointer that parses, so a
|
|
23
|
+
* bad pointer is caught where it's built rather than where it's loaded.
|
|
24
|
+
*/
|
|
25
|
+
export declare function formatDraftPointer(pointer: DraftPointer): string;
|
|
26
|
+
/** Anything with a `url` and `headers`: a fetch `Request`, a `NextRequest`, a framework wrapper. */
|
|
27
|
+
export type RequestLike = Request | {
|
|
28
|
+
url: string;
|
|
29
|
+
headers: Headers;
|
|
30
|
+
};
|
|
31
|
+
/**
|
|
32
|
+
* The draft pointer a request carries: `?__draft=` from the URL first, then
|
|
33
|
+
* the `deco-draft` cookie. `null` when neither is present, or when the URL
|
|
34
|
+
* says `?__draft=off`. The value is returned as is; `cms.forDraft` validates it.
|
|
35
|
+
*/
|
|
36
|
+
export declare function draftPointer(request: RequestLike): string | null;
|
|
37
|
+
/**
|
|
38
|
+
* The `Set-Cookie` value for a request whose URL carries `?__draft=`: one that
|
|
39
|
+
* stores the pointer, or one that expires the cookie when the value is `off`
|
|
40
|
+
* (how the site editor ends a preview). `null` on every other request, and for
|
|
41
|
+
* a pointer that doesn't parse, so garbage never lands in the cookie.
|
|
42
|
+
*
|
|
43
|
+
* The site editor previews your site inside a cross-site iframe, so the cookie
|
|
44
|
+
* is `Secure; SameSite=None; Partitioned` (CHIPS): `SameSite=Lax` would never
|
|
45
|
+
* be sent there. `HttpOnly` keeps page scripts from reading the pointer.
|
|
46
|
+
*/
|
|
47
|
+
export declare function draftCookie(request: RequestLike): string | null;
|
|
48
|
+
//# sourceMappingURL=draft.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/v8/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAE9D,qGAAqG;AACrG,eAAO,MAAM,YAAY,eAAe,CAAC;AAezC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,IAAI,CAoBrF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAiBhE;AA4DD,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAM/D"}
|